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

Repo Cleanup #16

Open
19 tasks
hunterowens opened this issue Aug 15, 2013 · 0 comments
Open
19 tasks

Repo Cleanup #16

hunterowens opened this issue Aug 15, 2013 · 0 comments

Comments

@hunterowens
Copy link
Member

Directory Structure

  • Clean, Well named set of directories. Examples include webapp, database, and models.
  • No random files in the root.
  • Explanation of each directory in README.
  • Sub-README's in appropriate folders
  • No directories named after DSSG specific info (ie, person names)
  • Should your team have more than one project, each should have it its own repo.
  • In your data or database folder, provide a way to re-create your database from scratch. .sql files are often appropriate for this.

README

  • Links to appropriate sections in wiki. See wiki issue for more info.
  • Answers: What have you built? In a few sentences.
  • Answers: How do you install it?
  • Answers: What needs to be done/How can I help?
  • Has some sort of Contact Info
  • Open source license
  • Future Issues opened.

Config

  • No public facing config info - Make sure never to hardcode in database url, password, etc.
  • Description of how you hide config info, ie yaml, environment variables, etc
  • config.example files
  • Requirements.txt or similar file.
  • Relative links in any html.
@apanella apanella closed this as completed Sep 3, 2013
@apanella apanella reopened this Sep 3, 2013
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

No branches or pull requests

2 participants