-
-
Notifications
You must be signed in to change notification settings - Fork 934
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
docs: Documenting how to write documentation #1721
Conversation
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.
Very nice!
Co-authored-by: Lukas Klingsbo <[email protected]>
@@ -0,0 +1,5 @@ | |||
# Development |
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.
would Contributing be a better name? development could refer to game development in general
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.
On that topic; it would be nice to include the CONTRIBUTING.md
file in this category too.
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.
Yes, we could eventually publish a variety of things here, such as
- the main "contributing" guideline;
- various policies;
- schedule of future releases, and/or events (such as FlameCons);
- mirror of the changelog, so that it is easier to find;
- etc.
The term "development" seem to be more generic and capable of fitting more topics.
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 think development is fine as a topic, since contributing should refer to the specific contributing.md doc.
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.
Very meta!
Since our documentation is fairly complex, we need to have a document which describes how various parts of it work. This PR adds such documentation.
Description
Since our documentation is fairly complex, we need to have a document which describes how various parts of it work. This PR adds such documentation.
Checklist
fix:
,feat:
,docs:
etc).docs
and added dartdoc comments with///
.examples
.Breaking Change
Related Issues