Technical Reference
How To Contribute
Please just do a regular contribution on our GitHub Repository.
Please note that this is a different repository than the tutorial repository.
Contribution Workflow
If there's an error in the dpANSr text that you are fixing, then change it right away in the relevant file. They are usually the files with the _
prefix.
For adding examples and explanations, please edit the corresponding file (usually the one without the _
prefix), or you can create a separate file marked section-number-examples.md or section-number-explanations.md and add an import in the appropiate section. The purpose of this is to keep separate the community added explanations and examples from the original specification. That way it will be easier to modify and add things in the future without having to worry about modifying the original spec. It will also be clear what is the original vs. the new content.
For all the dicionary item pages there already are "Expanded Reference" sections. For example the and macro page already has a contribution.
Please note the difference between the expanded reference file and the original specification file
What To Contribute
- Examples of any aspect mentioned in the reference
- Explanations of any aspect of the reference.
- Fixes to the original specification when there were error. Please note the change with an "info" admonition if that is the case. Here's a sample admonition (The "INFO" box near the bottom). Here are the admonition docs.
- Whatever you think will make this reference better!
Please also see our TODO page for more information on what to contribute and project TODO's.
Sample Contributions
Here is a sample commit which shows a fix to the original specification. Please note the admonition by surounding the text with \n:::info\n
and \n:::\n
.