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

Feature docs #18

Merged
merged 5 commits into from
Jan 15, 2019
Merged

Feature docs #18

merged 5 commits into from
Jan 15, 2019

Conversation

looselycoupled
Copy link
Member

This PR is primarily to add comments and update documentation however there are a few minor bug fixes included that were uncovered during documentation.

This is a rather large amount of docs however it should be pretty straightforward to read. I'll also attach a zip of the HTML that it builds if that helps the review process.

I'd like to call this done for now pending comments, requested changes, etc. The docs are another case where it can be an unlimited time sink if you let it but I think it's of high enough quality that we can put it out as it stands as long as nothing is incorrect.

@immesys please pay particular attention to the docs surrounding windowing as I feel less confident about some of my explanations.

Once we are both happy enough to merge to the develop branch then it will be automatically built and available online at https://btrdb.readthedocs.io/en/develop/ but will not replace the official version at https://btrdb.readthedocs.io/en/latest/.

@looselycoupled
Copy link
Member Author

See attached zip file for the browseable version of the docs.

build.zip

Copy link
Member

@immesys immesys left a comment

Choose a reason for hiding this comment

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

Looks good! A few minor points here and there

btrdb/point.py Outdated Show resolved Hide resolved
btrdb/point.py Outdated Show resolved Hide resolved
btrdb/point.py Outdated Show resolved Hide resolved
btrdb/point.py Outdated Show resolved Hide resolved
btrdb/point.py Outdated Show resolved Hide resolved
docs/source/concepts.rst Outdated Show resolved Hide resolved
docs/source/concepts.rst Show resolved Hide resolved
docs/source/working.rst Outdated Show resolved Hide resolved
docs/source/working/stream-view-data.rst Show resolved Hide resolved
docs/source/working/streamsets.rst Outdated Show resolved Hide resolved
@looselycoupled
Copy link
Member Author

@immesys I've implemented all of your comments although I couldnt fix the odd github rendering of the subheading. I think it might have to do with the dashes used a few lines below in the table. It does not appear to affect HTML rendering though so I suggest we ignore it for now.

Sorry but I resolved the request changes as I did them not realizing that I would be removing the breadcrumbs for you to review.

Finally, I just asked for permissions to integrate with Travis. It seems there were multiple hurdles for me to get this done. Once it's complete I'll have one more commit although I can do that in a separate, tiny PR instead if you prefer.

@immesys immesys merged commit 8e0fd07 into BTrDB:develop Jan 15, 2019
@looselycoupled looselycoupled deleted the feature-docs branch January 30, 2019 22:19
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