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

Autodoc confdefs #1772

Merged
merged 13 commits into from
Jun 16, 2020
Merged

Autodoc confdefs #1772

merged 13 commits into from
Jun 16, 2020

Conversation

vEpiphyte
Copy link
Contributor

@vEpiphyte vEpiphyte commented Jun 15, 2020

  • Part out devops guide into discrete portions
  • Update autodoc to generate a enumerated list of configuration options for a Cell
  • UPdate autodoc to be able to generate RST documents for stormservice configurations.
  • Add configuration notes about the Cell.
  • Add autodoc data to the docs for the Cortex, Axon, Cryotank and SyncMigrator

lines = []
lines.append(desc)

extended_description = conf.get('extended_description')
Copy link
Contributor Author

Choose a reason for hiding this comment

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

This allows us to embed reform sphinx RST into confdefs

@codecov
Copy link

codecov bot commented Jun 15, 2020

Codecov Report

Merging #1772 into master will decrease coverage by 3.32%.
The diff coverage is 94.59%.

Impacted file tree graph

@@            Coverage Diff             @@
##           master    #1772      +/-   ##
==========================================
- Coverage   96.14%   92.81%   -3.33%     
==========================================
  Files         139      139              
  Lines       26331    26474     +143     
==========================================
- Hits        25315    24571     -744     
- Misses       1016     1903     +887     
Flag Coverage Δ
#linux 92.81% <94.59%> (-3.33%) ⬇️
#linux_replay 66.05% <2.02%> (-0.43%) ⬇️
Impacted Files Coverage Δ
synapse/cortex.py 94.25% <ø> (-1.24%) ⬇️
synapse/tools/autodoc.py 95.10% <93.93%> (-0.74%) ⬇️
synapse/lib/config.py 100.00% <100.00%> (ø)
synapse/lib/hashset.py 0.00% <0.00%> (-100.00%) ⬇️
synapse/lib/interval.py 0.00% <0.00%> (-100.00%) ⬇️
synapse/tools/pushfile.py 0.00% <0.00%> (-100.00%) ⬇️
synapse/tools/cellauth.py 0.00% <0.00%> (-98.49%) ⬇️
synapse/tools/cryo/cat.py 0.00% <0.00%> (-95.35%) ⬇️
synapse/tools/pullfile.py 0.00% <0.00%> (-91.67%) ⬇️
synapse/cmds/hive.py 18.84% <0.00%> (-81.16%) ⬇️
... and 27 more

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 83a164e...ed05d72. Read the comment docs.

@vEpiphyte vEpiphyte closed this Jun 16, 2020
@vEpiphyte vEpiphyte reopened this Jun 16, 2020
mikemoritz and others added 2 commits June 16, 2020 18:35
* update storm service docs

* split out cell config docs

* move cell config to its own file

* Add unit tests for new autodoc functionality.

Co-authored-by: epiphyte <[email protected]>
* Add autodocs support for generating rst from a stormservice definition

Co-authored-by: redox <[email protected]>
@vEpiphyte vEpiphyte added this to the 2.1.0 milestone Jun 16, 2020
@vEpiphyte vEpiphyte merged commit a224425 into master Jun 16, 2020
@vEpiphyte vEpiphyte deleted the autodoc_confdefs branch June 16, 2020 21:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants