Commit Graph

42 Commits

Author SHA1 Message Date
Pisit Sawangvonganan 512dc9ff38 doc: fix typo in multiple directories (build, hardware, kernel, project)
Utilize a code spell-checking tool to scan for and correct spelling errors
in all files within the doc/build, hardware, kernel, project directory.

Signed-off-by: Pisit Sawangvonganan <pisit@ndrsolution.com>
2024-01-26 13:16:18 +01:00
Flavio Ceolin 96c20d831e doc: roles: Remove ambiguity for static analysis
Remove possible ambiguity in the static analysis audit team
rights and responsabilities.

Signed-off-by: Flavio Ceolin <flavio.ceolin@intel.com>
2024-01-06 11:57:36 -05:00
Flavio Ceolin dd58f80fe2 doc: Static Analysis requirement
Sets static analysis  an indispensable requirement for our project
releases.

Static analysis is not merely a tool but a proactive
strategy to unearth and address potential issues in the early stages
of development, long before they mature into critical
vulnerabilities. By scrutinizing code at rest, static analysis unveils
latent defects and potential security risks, thus bolstering the
resilience of our software against future threats.

Fixes: #64591

Signed-off-by: Flavio Ceolin <flavio.ceolin@intel.com>
2024-01-02 10:09:14 +01:00
Carles Cufi d053b8bf3b doc: Rename stable API change to breaking change
It is often confusing for users and developers alike to see the sentence
"stable API change" in a label or in the release notes. Stable APIs can
change in at least two ways (retaining compatibility or not), and so it
is preferrable to use a term that clearly describes the change as
incompatible, by using the common term "breaking".

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2023-12-20 09:12:44 -05:00
Anas Nashif 538abf3332 doc: clarify role of CODEOWNERS and MAINTAINERS files
Change docs to use MAINTAINERS file as the main file for managing code
areas and 'ownership'.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-11-16 08:19:15 -05:00
Anas Nashif a6bfbedbf5 doc: project roles: Further finetune language
More details about roles and responsibilities and reviewer expectations.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-10-27 10:49:47 +02:00
Anas Nashif 79aaa9061c doc: release: update merge criteria
Document 4 eye principal for reviews and merges.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-09-27 20:13:04 -04:00
Anas Nashif 6dc15abb85 doc: roles: remove reference to slide
Reference to slide that does not exist.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-09-27 20:13:04 -04:00
Hein Wessels 8219c7ccda doc: release process: link to milestone dates on wiki
This adds a link for convenience. Many times before I struggled to
find the date for the next feature freeze. This is to help others,
and myself, to find it easier in the future.

Signed-off-by: Hein Wessels <heinwessels93@gmail.com>
2023-09-18 11:16:27 +01:00
Fabio Baltieri ecf29a77f8 doc: release: drop the notes about listing github issues
Drop the notes about listing all the github issues with the release
notes. That was a huge list of github issues sorted by closing time,
very noisy and hard to maintain.

The unfiltered list of changes is already in the commit history, a
distilled list is now in the blog posts and a final list is in the notes
summary.

The issue list has been skipped in 3.4 already, let's just drop it from
the process.

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2023-07-25 16:45:15 +02:00
Anas Nashif c1e40bb3d5 templates: change template file namaes for proper sorting
prefix with numbers to get sorting based on usage. Most common files
issue types should come first, with bugs being at the top.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-06-08 07:32:45 -04:00
Anas Nashif 6f1c764a92 doc: release: minor tweaks
Minor tweak about length of stabilization phase and the merge process.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-05-23 10:43:21 -04:00
Anas Nashif 8c410123b3 doc: releases: expand on release cycle and support
Add more information about release cycle and type of releases we have.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-05-23 10:43:21 -04:00
Anas Nashif 796d111289 doc: clarify topic branches
Rename topic branches to be collaboration branches, to avoid confusion
with common terminology of topic branches which serves a different
pupose.
Clarify collab branches and the need for TSC approval.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-05-17 17:41:37 -04:00
Keith Short 942e4a38d2 docs: Move RFCs into a separate document
The RFC proposal documentation better belongs with the other
documentation related to contributing to the Zephyr project.

Signed-off-by: Keith Short <keithshort@google.com>
2023-03-06 21:59:23 +01:00
Keith Short 34165a3480 docs: Add Contributor Expectations document
Collect up all the contributor expectations and PR requirements into a
single place. Add additional guidelines about creating small PRs and how
to break up PRs into multiple commits.

Signed-off-by: Keith Short <keithshort@google.com>
2023-03-06 21:59:23 +01:00
Martí Bolívar 25aab87f96 doc: project_roles: clarify maintainer rights
Be explicit that maintainers' decisions in their areas are final
unless overruled by the TSC.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2023-02-06 10:06:28 +01:00
Martí Bolívar 5c0a07fcf0 doc: communication: update stale info
At this point I think it's clear that discord is more important than
email as a discussion forum for the project, so clarify that on the
communication and collaboration page.

Email is still important, though (e.g. Discord is currently not
available in China) -- and we are not deprecating it at all.

Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
2023-02-03 20:53:37 +09:00
Fabio Baltieri 35ec706d82 doc: release process: drop the comment about changing the release name
Now that the automation picks the right name automatically, there's no
need to edit it manually as part of the release process.

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-10-24 11:17:00 -04:00
Fabio Baltieri 34f74c96b0 ci: release: stop creating releases for RC tags
RC releases clutter the release page, there's no reason for keeping them
after the release is done, filter them out from the workflow so they
don't get created in the first place..

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-10-10 07:25:15 -07:00
Fabio Baltieri 0da3b69b50 doc: release process: stop creating zephyr- prefixed tags
Drop the process step to create zephyr- prefixed tags.

This has been done so that autogenerated release files have a sensible
name, but GitHub started to automatically prefix the project names to
release artifacts anyway using HTTP headers, which now results in file
named like: zephyr-zephyr-v3.2.0.tar.gz, so the extra tags are now
causing the opposite problem.

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-10-07 13:07:14 +00:00
Fabio Baltieri fa51b3db1c doc: release process: only use the overview for the release page
Change the release process documentation to only use the overview of the
release notes for GitHub releases rather than the full file.

The current instructions of copying the full content are broken (the
file does not fit anyway and the formatting is incompatible) and result
in a cluttered page anyway (the UI is not really meant for long release
notes).

Signed-off-by: Fabio Baltieri <fabiobaltieri@google.com>
2022-10-07 14:32:42 +02:00
Carles Cufi 74d904ba72 doc: gh: Add RFC to the list of mandatory labels
The paragraph that lists the mandatory labels (at least one of them must
be set, and at most one of those) was missing RFC.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-06-30 17:01:58 -04:00
Carles Cufi 1c2873f2f3 doc: gh: Document the Hardware Support label
This label is widely used by not documented.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-06-30 17:01:58 -04:00
Carles Cufi 974e868b33 doc: gh: Remove the doc for the "Question" label
This label has been removed, since we now convert issues that are just
questions to Discussions.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-06-30 17:01:58 -04:00
Aleksandar Markovic e36fccbbf9 doc: Reword and reformat a sentence on review time
Move the sentence to the end of the section on labels applicable to
PRs only, reword it and convert to a note, indicating that the note
is for all labels in this section.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 641d2285b8 doc: Enhance subsection on "Security Review" label
Sync the text of description with what is seen in Github.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 4cdbdefb6d doc: Enhance subsection on "Maintainer" label
Sync the text of description with what is seen in Github.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 6e975769dd doc: Enhance subsection on "Hotfix" label
Sync the text of description with what is seen in Github.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 0836f71d3c doc: Enhance subsection on "Stable API Change" label
Remove part that it is not appropriate.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 60caee3a2f doc: Enhance description on "area: *" label
Use full label names for examples in the description, and other minor
enhancements.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 35e021d855 doc: Split and enhance subsections on "dev-review" and "TSC" labels
Split the explanation on dev-review and TSC labels into two separate ones,
and slightly reword both. For both, amend corresponding link to point to
the more relevant place in the online page on Zephyr meetings. Add
explanation for acronym "TSC".

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 3f20163cdd doc: Remove reference to now non-existant ext subdirectory
Directory <Zephyr-root>/ext does not exist anymore. Remove the
reference to it from the documentation.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic ada4195834 doc: Move subsection on "Stale" label to the right place
Label "Stale" is used for both issues and pull requests. It is currenly
listed as applicaple to pull requests only, however. Move it to the
right place.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 02040834d9 doc: Fix label names to be in sync with Github label names
Some label names in the documentation do not match with what is
seen in Github interface. Fix it by syncing with Github.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Aleksandar Markovic 3f1e43b9c7 doc: Rearrange content of section "Labeling issues and pull requests"
Mostly due to limited support for tables in rst format, information on
labels used for Zephyr issues and pull requests in Github is hard to
navigate and is visually not pleasing. Rearange the content of the
section so that bullets are mainly utilized rather than tables. Format
label names as 'emphasis', rather that 'monospace' (which should be
used primarily for code snippets, and Github labels are not code).
Also, group the information according to applicability (taking into
account if a label is applicable to:

  * issues only;
  * pull requests only;
  * both issues and pull requests.

Label names and decriptions are otherwise left 'as is' in this commit.

Signed-off-by: Aleksandar Markovic <aleksandar.markovic.sa@gmail.com>
2022-06-28 15:55:21 +02:00
Stephanos Ioannidis bd0f5f9816 doc: project: Fix role nomination template URL
This commit fixes the URL for the role nomination template that
incorrectly specified the 'bug' label instead of the 'Role Nomination'
label.

Signed-off-by: Stephanos Ioannidis <root@stephanos.io>
2022-06-17 10:27:49 -05:00
Carles Cufi 26294ced09 doc: Rename API meeting to Architecture meeting
As per the decision to rename this meeting and make it into a working
group, document this in the official docs.

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2022-06-14 16:07:38 +02:00
Anas Nashif 80f6a3adbc doc: release process: update milestone definition
Update milestone definitions to reflect current state of the release
process.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2022-04-19 12:26:38 -04:00
Anas Nashif 92c285e038 doc: releases: remove moderation levels
Remove obsolete information about moderation.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2022-04-19 12:26:38 -04:00
Anas Nashif c2f1b8db7b doc: releases: replace merge window terminology
Do not use the merge window terminology which can be confusing and use
"development phase" and "stabilisation phase" instead.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2022-04-19 12:26:38 -04:00
Anas Nashif 5b3b9c7c41 doc: create new section for project structure
Move all project and governance related docs into one new section.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2022-04-07 16:35:19 +02:00