Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sandbox process #269

Merged
merged 7 commits into from
Aug 7, 2024
Merged

Sandbox process #269

merged 7 commits into from
Aug 7, 2024

Conversation

dwelsch-esi
Copy link
Collaborator

Adding the "sandbox documentation primer"

dwelsch-esi and others added 3 commits July 30, 2024 12:49
Fix to sandbox updates
sandbox-doc-primer.md defines terms and outlines a process for getting started with project documentation in CNCF. 

Signed-off-by: Dave Welsch <[email protected]>
Signed-off-by: Nate W <[email protected]>
Comment on lines 204 to 205
[Open Source Documentation Essentials](https://training.linuxfoundation.org/training/open-source-technical-documentation-essentials-lfc111/)
[Creating Effective Documentation for Developers](https://training.linuxfoundation.org/training/creating-effective-documentation-for-developers-lfc112/)
Copy link
Member

@nate-double-u nate-double-u Jul 30, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@chalin, the linter is barking at these two lines (too long). How should we handle long url lines (or how can I tell the linter it's OK in this case?)

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@nate-double-u @chalin Problem seems to have been spaces at the ends of the lines. These two lines seem to be behaving now (the rule seems to be that links are exceptions to the 80-character line length limit). However, there's another formatter failure now caused by a Prettier violation. Is there a way to get Prettier to give more informative error messages?

dwelsch-esi and others added 4 commits August 1, 2024 09:42
- Added release notes as an example of reference doc
- Added links to more resources
- Minor edits

Signed-off-by: Dave Welsch <[email protected]>
Fixed format issue?

Signed-off-by: Dave Welsch <[email protected]>
Added info about CNCF hosting project websites.

Signed-off-by: Dave Welsch <[email protected]>
Signed-off-by: Nate W <[email protected]>
Copy link
Member

@nate-double-u nate-double-u left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this @dwelsch-esi!

We can make changes as feedback comes in if we'd like, but this is a great primer as is.

@nate-double-u nate-double-u merged commit 167a9e3 into cncf:main Aug 7, 2024
5 checks passed
Dindihub pushed a commit to Dindihub/TUF-docs-analysis that referenced this pull request Aug 10, 2024
* Added sandbox doc primer

sandbox-doc-primer.md defines terms and outlines a process for getting started with project documentation in CNCF. 

Signed-off-by: Dave Welsch <[email protected]>

* fixing formatting

Signed-off-by: Nate W <[email protected]>

* Update sandbox-doc-primer.md

- Added release notes as an example of reference doc
- Added links to more resources
- Minor edits

Signed-off-by: Dave Welsch <[email protected]>

* Update sandbox-doc-primer.md

Fixed format issue?

Signed-off-by: Dave Welsch <[email protected]>

* Update sandbox-doc-primer.md

Added info about CNCF hosting project websites.

Signed-off-by: Dave Welsch <[email protected]>

* fixing formatting

Signed-off-by: Nate W <[email protected]>

---------

Signed-off-by: Dave Welsch <[email protected]>
Signed-off-by: Nate W <[email protected]>
Co-authored-by: Nate W <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants