-
Notifications
You must be signed in to change notification settings - Fork 29
Update READMEs #148
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
Update READMEs #148
Conversation
21cafbf to
78d3124
Compare
Our READMEs on the fluent packages are lacking. Create some, and use them in setup.py to add better content on pypi. Also convert to restructuredText to align with rest of docs. The documentation for fluent.pygments is really just to demo the highlighting.
fluent.runtime/README.rst
Outdated
| =============================== | ||
|
|
||
| Use `Fluent`_ to localize your Python application. It comes with a ``Localization`` | ||
| class to use, based on an implementation of bundle. It uses the parser from |
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.
The way it's used here, bundle is a bit enigmatic. Perhaps mention FluentBundle, i.e. the class?
(I realize this is copied from the current README; if you'd prefer to fix this later rather than in a drive-by, that's fine with me.)
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.
Fixed this in both READMEs.
fluent.syntax/README.rst
Outdated
| ``fluent.syntax`` |fluent.syntax| | ||
| --------------------------------- | ||
|
|
||
| Process, analyze, and transform `Fluent`_ files. |
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.
Perhaps explicitly mention parsing and serializing?
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.
Or: Read, write, and transform...?
Our READMEs on the fluent packages are lacking.
Also convert to restructuredText to align with rest of docs.