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

readme.rst #47

Draft
wants to merge 2 commits into
base: main
Choose a base branch
from
Draft

readme.rst #47

wants to merge 2 commits into from

Conversation

aajayi-21
Copy link
Contributor

@aajayi-21 aajayi-21 commented Aug 13, 2023

I have made a branch to add the README.rst file (like diffpy.pdfmorph). I'm not sure if this is automatically created by Sphinx or another process. I've only added the sections so far. Should I fill the file in a similar way to README.rst in diffpy.pdfmorph?

@sbillinge
Copy link
Contributor

Typically I don't mind if the README is .rst or .md. On balance I prefere .md because it doesn't require building.

However, the full documentation (in the doc folder) should be in .rst so it can be built into a website or pdf.

If this PR is about the readme, just go with .md, but if this is starting to build the user documentation, do it in the doc folder and use .rst.

Copy link
Contributor

@sbillinge sbillinge left a comment

Choose a reason for hiding this comment

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

good start. I added one comment


## LICENSE

This software is subject to license and copyright restrictions listed here.
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we will make this open source, so let's give it a BSD-3 clause license.

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