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

Revise the documentation #63

Open
wants to merge 9 commits into
base: dev
Choose a base branch
from
Open

Revise the documentation #63

wants to merge 9 commits into from

Conversation

uvchik
Copy link
Member

@uvchik uvchik commented Jun 17, 2021

There are still some old parts in the documentation but also new parts. We need to bring everything in line and decide what to keep and what to remove.

  • Changelog vs. Whatsnew: I merged both variants in changelog.rst. Now we have to decide.
    • Shall we use the old structure or one file?
    • Shall we use changelog or whatsnew (I would prefer changelog)
  • Check all important parts (Installation, examples, usage)
  • Compile sphinx without warnings (or at least few warnings)
    • First sketch without warnings and broken links
  • Fix all references
  • Missing content?
    • Basic usage.
    • General information: Overview weather data/models
  • ...

See this branch on readthedocs

There are still some old parts in the documentation but also new parts.
We need to bring everything in line and decide what to keep and what to
remove.
@uvchik uvchik added this to the v0.1.0 milestone Jun 17, 2021
@uvchik uvchik self-assigned this Jun 17, 2021
@uvchik uvchik mentioned this pull request Jun 17, 2021
3 tasks
Now both variants are integrated but we have to decide which one to
take. Using separate file as we did before or using one changelog file
like CHANGELOG.rst
We have to clean this site.
We have to add the examples again but we should discuss how.
@uvchik
Copy link
Member Author

uvchik commented Jun 21, 2021

@oemof/feedinlib : I would appreciate some help, ideas and feedback.

@birgits
Copy link
Member

birgits commented Jul 17, 2021

@uvchik what is the difference between changelog and what's new? I don't have a strong opinion on it but if there is no advantage of changelog over what's new I would just keep it as it is.

I will add some information on the weather data, otherwise I think the documentation is fine. I also think the basic usage part of the documentation is fine. What would you add or change?

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.

None yet

2 participants