-
-
Notifications
You must be signed in to change notification settings - Fork 40
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
Add summary of capabilities/user stories to docs index page #149
Conversation
Codecov Report
@@ Coverage Diff @@
## main #149 +/- ##
==========================================
+ Coverage 72.60% 75.46% +2.86%
==========================================
Files 9 9
Lines 646 693 +47
==========================================
+ Hits 469 523 +54
+ Misses 177 170 -7
📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more |
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.
Hi @rosteen, thanks for the pull request. I like the content and think it would be good to rearrange it. My suggestions:
- Leave the first sentence as is ("The specreduce package aims...").
- Combine the beginning of the second sentence (up to "...basic spectroscopic reduction") and your first sentence ("Specreduce is currently useful...") into something like "Specreduce is currently most useful for the following steps in basic spectroscopic reduction:"
- Leave your numbered list as is.
- Paste the rest of the original second sentence after the list – I think it's better to list what we can't do and where else to go only after what we've given details on what we can do.
@ojustino I made some edits, does it sound better to you now? |
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 looks comprehensive to me. I have some assorted suggestions and am ready to approve once you've made decisions on them.
docs/index.rst
Outdated
basic spectroscopic reduction, currently encompassing the following three tasks: | ||
|
||
#. Determining the trace of a spectrum dispersed in a 2D image, either by setting a flat | ||
trace or fitting a spline, polynomial, or other model to the positions of the dispersed |
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 would also add that users can set a custom trace so ArrayTrace
isn't left out.
Co-authored-by: ojustino <ojustino@users.noreply.github.com>
@ojustino I put in all your suggestions, thanks! |
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.
Thanks again, @rosteen.
As it says in the title - I hope that this is something close to what you were imagining for the "user stories" on the docs landing page, to give people an idea of what they might use
specreduce
for. If I'm off the mark let me know.