/style-guides

An opinionated guide to setting up STScI-owned GitHub repositories

Creative Commons Attribution 4.0 InternationalCC-BY-4.0

Style Guides

This repository contains styles guides, suggested workflows, and best practices for sofware-related content developed by STScI staff. Style guides are designed to ensure that STScI software, GitHub repositories, documentation, and example analyses follow a consistent style. Suggested workflows provide robust methods for producing work to help aid collaboration and maximize clarity. While we recommend reading the full policies and further material, we highlight some of the most common best practices that are applicable to our software projects.

Currently there are styles guides for:

In addition, there are the following guides for best practices and workflows:

Related work

Contributing

If you want to suggest changes to this content do the following:

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request