With close to 20 different links, the Resources section was not really
easy to navigate, defeating the purpose of providing quick access to
information. Reworked the section to break it down into sub sections,
and reworded the links to make them self explanatory.

Each sub-section has been re-ordered so that most important links appear
first.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>

removed stale mention of nightly builds

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>

Use the mechanism described here:
https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#specifying-the-theme-an-image-is-shown-to



to provide different logos for light and dark mode, so that the "Zephyr"
text is clearly visible in both.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

This commit updates the references to the documentation pages that were
relocated in the PR #41154.

Signed-off-by: Stephanos Ioannidis <root@stephanos.io>

Add all missing architectures to the README.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Use an SVG based logo with embedded style that toggles title color using
media queries. The SVG logo is not exactly the same as the previous one
as I only had this version in SVG (taken from docs actually).

Note that we cannot use the method described in
https://github.blog/changelog/


2021-11-24-specify-theme-context-for-images-in-markdown/ because the
README is written in rst, not Markdown.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>

Update CI docs and the badge with links pointing to GH actions rather
than buildkite.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

After the Technical Steering Committee decided to approve the transition
from Slack to Discord, it is necessary to update all the documentation
to reflect this change.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

Logo was accidentally deleted as part of some docs cleanup. Add it back
with a new name making it more explicit that it belongs to the readme.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>

Point to the new branch to get the correct status.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Otherwise we end up with a self-reference to the same page we are in.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Update slack invite.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Adapt link after page move.

Fixes #36319
Signed-off-by: Anas Nashif <anas.nashif@intel.com>

We now use buildkite and GH actions.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Now that we have finished migrating CI from shippable to buildkite,
update the status badge on README.rst.

Signed-off-by: Maureen Helm <maureen.helm@nxp.com>

Point to zephyr/sdk release pages instead of non-existent downloads page
on project website.

Fixes #21706

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Remove leading/trailing blank lines in .c, .h, .py, .rst, .yml, and
.yaml files.

Will avoid failures with the new CI test in
https://github.com/zephyrproject-rtos/ci-tools/pull/112

, though it only
checks changed files.

Move the 'target-notes' target in boards/xtensa/odroid_go/doc/index.rst
to get rid of the trailing blank line there. It was probably misplaced.

Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>

As presented to the TSC, Zephyr's out-of-box experience for new
developers is, well, complicated.  A number of suggestions were
presented including simplifying the getting started material to present
a straight-forward path through the setup and installation steps through
to getting a sample application built, flashed, and running.

This PR is a work-in-progress towards addressing this OOB experience
with a minimal-distractions version of the GSG. Alternatives, warnings,
and material that could lead the developer astray were moved to
alternative/advanced instruction documents (based on the previous
separate Linux/macOS/Windows setup guides) and a new "Beyond the GSG"
document.

We do take advantage of a sphinx-tabs extension for synchronized tabs to
present OS-specific instructions: clicking on one tab will display all
same-named tabs throughout the doc.

We hope (and will continue evaluating) that this new GSG gets developers
set up quickly and then we can send them along to other documents to
continue learning about Zephyr and trying other sample apps.

Thanks for all your previous feedback that I've worked
into this new version.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

The project's README.rst references the support board docs with an URL
that's not working these days (see
https://github.com/zephyrproject-rtos/infrastructure/issues/134

) so fix
that URL reference.  While looking for other similar linking cases, I
found a hard URL references that should be using :ref: role, and a
release notes reference to a (now) broken link (fixing that in the
/latest/ version of the 1.10 release notes).

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

The old link seems not to work anymore, so instead replace it with an
invitation link freshly generated.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

builds@lists.zephyrproject.org archives the CI build results for every
and nightly build.  Add references to this in the contribution
guidelines and introduction (pulled from README).

Also added a reference to the "Asking for Help" doc (there was a note to
add this once that doc was merged).

Fixes: #15652

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

This is a bit wordy. Let's let the bold text and links stand on their
own; anybody looking at a README on GitHub or in technical
documentation probably knows what these things mean.

Signed-off-by: Marti Bolivar <marti.bolivar@nordicsemi.no>

append /index.html, and now browser loads page with CSS.

Signed-off-by: Ivan kyb Kuvaldin <i.kyb@ya.ru>

Move all lead pages to be index pages and create redirect rules from the
old pointers.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Fixed link to the contribution guide.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Add a link to the slack channel and updated IRC info.

Fixes #11592

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Fixed URL to documentation, now latest docs are under /latest/..
Fixes #9932

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Correct a couple of architecture capitalizations and spellings.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

Add a Getting Started section in the README.rst for quick and easy
access to what is arguably the most read page of our doc website.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

Replace the current title with an image containing the Zephyr logo for
the root README.rst, in order to make the GitHub landing page more
attractive.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>

Caught some misspellings missed by the normal review process.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

The mailing list hosting software change introduced some changes to
where mailing lists are hosted.  Update the docs to point at the
specific sublists rather than the top-level site.  (See issue #7437).

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

Remove extra indirection to documentation (and required
server link redirection) from https://zephyrproject.org/doc/...
to http://docs.zephyrproject.org/

...

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

A recent LF change to the Zephyr mailing list hosting software changed
the mailing list names and links to the message archives.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

Bootlin is kindly providing an instance of their Elixir source code
cross-referencer tool with an index of the Zephyr kernel and samples
code.

This fixes #1420

Signed-off-by: Henrik Brix Andersen <henrik@brixandersen.dk>

Fix links to content on the new version of zephyrproject.org that moved.

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>

This patch adds information about the security related issue
tracking.

Signed-off-by: Andy Gross <andy.gross@linaro.org>

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Signed-off-by: Anas Nashif <anas.nashif@intel.com>

Zephyr Security WG requests listing a point of contact on the main
GitHub repo README for security-related inquiries. (This section of
the README is also included in the project intro page, via include
directive.)

Signed-off-by: David B. Kinder <david.b.kinder@intel.com>