-
Notifications
You must be signed in to change notification settings - Fork 527
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
Feat/style guide #900
base: 2024
Are you sure you want to change the base?
Feat/style guide #900
Conversation
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.
Just suggesting some minor changes. Thanks for all the hard work!
|
||
### Body of a Paper | ||
|
||
The body of a paper should contain the following sections; not every paper will have each of these sections. |
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 we can make "not every paper will have each of these sections." italicized or bold to emphasize.
For general Style Guide details please check [IEEE style guide](https://www.ieee.org/content/dam/ieee-org/ieee/web/org/conferences/style_references_manual.pdf). For inclusive language, please refer to [American Psychological Association’s style guide](https://www.apa.org/about/apa/equity-diversity-inclusion/language-guidelines). This style guide is based on both these references. Use [Strunk and White 4th edition](https://archive.org/details/TheElementsOfStyle4thEdition) as a grammar reference. We use [Merriam-Webster](https://www.merriam-webster.com/) as the English dictionary. | ||
|
||
|
||
### Paper Title |
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.
### -> ##
, and if this is the case, all subsequent title levels may require changes.
|
||
Please refer to this guide along with the current [README](https://github.com/scipy-conference/scipy_proceedings/blob/2024/README.md) of the repository for the proceedings. | ||
|
||
There is a page limit of 8 pages on the paper, excluding references. |
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.
This is a pretty important piece of information so I think it needs a separate title.
@@ -0,0 +1,121 @@ | |||
# Style Guide for SciPy Conference Proceedings |
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.
I think this part might require some introduction to answer questions like:
- what is the purpose of this doc?
- how should the authors and reviewers use this?
- is this mandatory or a mere suggestion?
- what is the motivation behind the style guide?
If we can answer these questions, I think we can increase engagement. The answers can be included in the style guide or in README
If you are creating this PR in order to submit a draft of your paper, please name your PR with
Paper: <title>
. An editor will then add apaper
label and GitHub Actions will be run to check and build your paper.See the project readme for more information.
Editor:
Reviewers: