-
Notifications
You must be signed in to change notification settings - Fork 5
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
All-in-one doc template idea #16
Conversation
- This includes several sections usable for one or more document types: how-to, article, FAQ, and so forth. - A writer picks one of the templates and discards the rest of the markup. - The templates are displayed as code blocks by indenting 4 characters; this makes the markup visible on the rendered page. To use the template, the 4 characters must be removed. - All of this are just some ideas of how to create and maintain a single template. Signed-off by: Karsten Wade <kwade@redhat.com> <quaid@iquaid.org>
template-handbook-article.md
Outdated
@@ -0,0 +1,147 @@ | |||
<!-- Title, author, date block standard in all files --> | |||
# Title (ex: How to Use `o1-clone` tool) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I would just suggest making "Use" lowercase instead, since we want the titles to be in sentence case. Other than that, I think it looks good!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Also, maybe this document should go in the contributing folder?
Signed-off by: Karsten Wade <kwade@redhat.com> <quaid@iquaid.org>
- This makes sense to have an easy directory with the files for contributing. - We'll have to link some/all of it into the Community Handbook, as well. Signed-off by: Karsten Wade <kwade@redhat.com> <quaid@iquaid.org>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks great! So sorry for the delay, I didn't see the updates until just now!
/lgtm
[APPROVALNOTIFIER] This PR is APPROVED This pull-request has been approved by: margarethaley The full list of commands accepted by this bot can be found here. The pull request process is described here
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
Signed-off by: Karsten Wade kwade@redhat.com quaid@iquaid.org