Skip to content

CONTENT: documentation text and styles #6

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

Merged
merged 13 commits into from
Nov 1, 2022
Merged

CONTENT: documentation text and styles #6

merged 13 commits into from
Nov 1, 2022

Conversation

lwasser
Copy link
Member

@lwasser lwasser commented Oct 26, 2022

This contains only the content for documentation and style updates
Will support faster updating!

Files to Remove

  • Jupyter logos
  • PSD file

Cleanup Items

  • Working on a better introduction to the documentation section
  • Cleaned up the contributing guide and added a card to the book's landing page
  • Working on the "about readme files" content to be super specific about what a readme should contain and how it should be structured. goal: have scientists spend a bit of time creating a clean, easy to read readme. and maybe i can then create a blog on this topic too.


## Other recommendations
### Python version support
You should always be explicit about which versions of Python your package supports.
Copy link
Member Author

Choose a reason for hiding this comment

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

This should be in the package structure section MOVE...

Copy link
Member Author

Choose a reason for hiding this comment

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

This is all commented out. i didn't want to lose text so i commented it as i'm reorganizing it all...

A good rule of thumb is that the package should support, at least,
the latest three Python versions (e.g., 3.8, 3.7, 3.6).

### Code Style
Copy link
Member Author

Choose a reason for hiding this comment

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

This belongs in the code style section

@lwasser
Copy link
Member Author

lwasser commented Oct 27, 2022

Ok this is ready for a review if anyone wants to review. I'll leave it open for 4 days with the goal of merging it next wednesday November 2. the pr is failing because the circle ci config file isn't in this pr yet.

i'm still getting dup builds on merge and pull and would love to fix that but my fix didn't work.

color: #1abc9c;
}

@media (min-width: 720px){
Copy link
Member Author

Choose a reason for hiding this comment

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

TODO for another PR - clean up this mess of CSS. hey that rhymed. i'm a poet and didn't know it. Till i made a mess of the CSS.

oops. i did it again.

@@ -0,0 +1,7 @@
<!-- custom head content-->
Copy link
Member Author

Choose a reason for hiding this comment

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

This needs to go bye bye cause it don't work. i thought it was to modify the but instead it modifies the HTML header on the page not the head code. boo.

@@ -0,0 +1,176 @@
# README File Guidelines and Resources

https://devguide.ropensci.org/building.html#readme
Copy link
Member Author

Choose a reason for hiding this comment

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

oops will comment this out! all of my github tools disappeared today so i can't do it here? ?como?


Please go through this list before submitting your package to pyOpenSci

```
Copy link
Member Author

Choose a reason for hiding this comment

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

Eventually will be an include file so it can be ported elsewhere if need be.

as you release updates.


## API documentation
Copy link
Member Author

Choose a reason for hiding this comment

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

This is just a start - this file isn't at all done yet so please focus review on the readme for now. but anyone is welcome to read what is here now too.. just know it's just a start.

index.md Outdated
@@ -126,4 +146,101 @@ Removing button for the time being
Get Involved (Maybe a link to a get involved page)
``` -->

<!--
Copy link
Member Author

Choose a reason for hiding this comment

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

This is all commented out. i need to make sure it's all in the readme file but you can ignore this as it won't render on the page.

@lwasser
Copy link
Member Author

lwasser commented Nov 1, 2022

Merging this and then moving to a fork for other pr's!!!

@lwasser lwasser merged commit d896bb7 into main Nov 1, 2022
@lwasser lwasser deleted the document branch November 1, 2022 22:54
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.

1 participant