Updated README.md, added contributor's guide, code of conduct, and de…

…v container. (#35)

* added contributors and code of conduct docs.

* added dev container.

* made new readme.

.devcontainer/Dockerfile

@@ -0,0 +1,16 @@
+# See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.166.1/containers/ubuntu/.devcontainer/base.Dockerfile
+
+# [Choice] Ubuntu version: bionic, focal
+ARG VARIANT="focal"
+FROM mcr.microsoft.com/vscode/devcontainers/base:0-${VARIANT}
+
+
+# [Optional] Uncomment this section to install additional OS packages.
+RUN export DEBIAN_FRONTEND=noninteractive \
+  && sudo apt-get update \
+  && sudo apt-get -y install golang
+
+RUN go get -v golang.org/x/tools/gopls
+RUN go get -u github.com/lukehoban/go-outline
+RUN go get -u github.com/uudashr/gopkgs/cmd/gopkgs
+RUN go get github.com/go-delve/delve/cmd/dlv

.devcontainer/devcontainer.json

@@ -0,0 +1,27 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
+// https://github.com/microsoft/vscode-dev-containers/tree/v0.166.1/containers/ubuntu
+{
+  "name": "allbase - Ubuntu",
+  "build": {
+    "dockerfile": "Dockerfile",
+    // Update 'VARIANT' to pick an Ubuntu version: focal, bionic
+    "args": { "VARIANT": "focal" }
+  },
+
+  // Set *default* container specific settings.json values on container create.
+  "settings": {
+    "terminal.integrated.shell.linux": "/bin/bash"
+  },
+
+  // Add the IDs of extensions you want installed when the container is created.
+  "extensions": ["golang.go", "ms-vsliveshare.vsliveshare-pack","redhat.vscode-yaml","yzhang.markdown-all-in-one","premparihar.gotestexplorer","github.vscode-pull-request-github","streetsidesoftware.code-spell-checker","eamodio.gitlens"]
+
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  // "forwardPorts": [],
+
+  // Use 'postCreateCommand' to run commands after the container is created.
+  // "postCreateCommand": "uname -a",
+
+  // Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
+  // "remoteUser": "vscode"
+}

CODE_OF_CONDUCT.md

@@ -0,0 +1,125 @@
+
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant version 2.0](https://www.contributor-covenant.org/version/2/0/code_of_conduct.html).
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+For answers to common questions about this code of conduct, see the [FAQ](https://www.contributor-covenant.org/faq).
+
+[Translations are also available](https://www.contributor-covenant.org/translations).

CONTRIBUTING.md

@@ -0,0 +1,123 @@
+# Introduction
+
+Yo, what up! if you're reading this then I'm super psyched because that means that you're thinking about contributing to Allbase! Thanks so much for your time and consideration. It's rad people like you that make Allbase such a cool computational synthetic biology tool.
+
+I wrote this contributor's guide to help newcomers feel welcome. Getting started with a new project can be complicated and I wanted to make it as easy as possible for you to contribute and as easy as possible for me to help.
+
+Currently any sincere pull request is a good request.
+Allbase is still in pre-release so there are so many way to contribute!
+Here's a list of ideas but feel free to suggest anything I may have forgotten to include.
+
+* Feature requests - especially cool new algorithms with citations.
+* Devops features. Github action bots, linters, deployment, etc.
+* Unit and integration tests.
+* Writing, editing, and translating tutorials, documentation, or blog posts.
+* Auditing for accessibility.
+* Bug reports.
+* Bug triaging.
+* Community management.
+* Art! Dreams! Your excellence!
+* Code that can be pulled into Allbase itself.
+
+# Contributor guidelines
+### Excellence, and the contributor's code of conduct
+
+First up, most importantly we have a contributor's code of conduct. For some reason the internet is a dehumanizing experience and it's easy to forget that aside from the bots we're all humans on this thing. Approach each other with kindness. Please read our [contributor's code of conduct](CODE_OF_CONDUCT.md) and when in doubt just remember our one true rule as once spoken by the ever so wise duo of Bill and Ted.
+
+`Bill: Be excellent, ... to each other, ...`
+
+`Ted: and party on, dudes! [sic]`
+
+![Abraham Licoln saying, "Be Excellent to each other and party on dudes!". [sic]](https://media.giphy.com/media/ef0zYcF7AKu4b0Sns6/giphy-downsized-large.gif)
+
+### Do-ocracy
+
+Allbase runs on do-ocracy. Do-ocracy is a simple concept. If you don't like something you don't need permission to fix it, you can just go ahead and fix it! If you actually want to merge your fix, or contribute in someway that benefits everybody, it'd really, really, really help if you got some light consensus from the rest of the Allbase development community but hey, if you really need to do something then you just gotta do it! Just don't expect me to merge it if it doesn't meet our technical criteria or isn't quite right for Allbase.
+
+### Technical requirements
+
+Part of what makes Allbase so special is that we have standards. DNA is already spaghetti code on its own and we just don't need to add to that.
+
+All successfully merged pull requests must meet the following criteria: 
+
+* All current tests must pass.
+
+* At least one new test must be written to prove that the merged feature works correctly.
+
+* At least one new [example test](https://blog.golang.org/examples) must be written to demonstrate the merged feature in our docs.
+
+* Build tests must pass for all currently supported systems and package managers. Linux, Mac OSX, Windows, etc.
+
+* Code must be clean, readable, and commented. How you do that is up to you!
+
+Don't worry if you submit a pull request and all the tests break and the code is not readable. We won't merge it just yet and then you can get some feedback about what needs to be changed before we do!
+
+### Be welcoming
+
+As one final guideline please be welcoming to newcomers and encourage new contributors from all walks of life. I want Allbase to be for everyone and that includes you and people who don't look, sound, or act like you!
+
+# Your first contribution
+
+Unsure where to begin contributing to Allbase? You can start by looking through these beginner and help-wanted issues:
+
+[Beginner issues](https://github.com/TimothyStiles/allbase/issues?q=is%3Aissue+is%3Aopen+label%3A%22beginner%22+) - issues which should only require a few lines of code, and a test or two.
+
+[Good first issues](https://github.com/TimothyStiles/allbase/contribute) - issues which are good for first time contributors.
+
+[Help wanted issues](https://github.com/TimothyStiles/allbase/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22+) - issues which should be a bit more involved than beginner issues.
+
+[Feature requests](https://github.com/TimothyStiles/allbase/labels/enhancement) - before requesting a new feature search through previous feature requests to see if it's already been requested. If not then feel free to submit a request and tag it with the enhancement tag!
+
+### Working on your first Pull Request? 
+
+You can learn how from this *free* series, [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
+
+You can also check out [these](http://makeapullrequest.com/) [tutorials](http://www.firsttimersonly.com/).
+
+At this point, you're ready to make your changes! Feel free to ask for help; everyone is a beginner at first :smile_cat:
+
+# Getting started
+
+For something that is bigger than a one or two line fix:
+
+1. Create your own fork of the code.
+2. Make a branch in your fork
+3. Do the changes in your fork's branch.
+4. Send a pull request.
+
+## Virtual Environments and Development Containers 
+
+In order to simplify the development experience, and environment setup, the allbase Github repository comes packaged to support *Github CodeSpaces* and [*VSCode Development Containers*](https://code.visualstudio.com/docs/remote/containers#_getting-started). *Github CodeSpaces* will give you ability to spin up a Github hosted instance of Ubuntu that would allow you run, test, develop allbase from the browser. *VSCode Development Containers* in turn will allow your installation of VSCode to spin up a docker instance of Ubuntu on your computer and automatically mount your code onto it so that you continue developing on this docker instance that has all the required development environment setup. 
+
+## Recommended Plugins
+
+Whether you're a beginner with Go or you're an experienced developer, You should see the suggestions popup automatically when you goto the *Plugins* tab in VSCode. Using these plugins can help accelerate the development experience and also allow you to work more collaboratively with other allbase developers.
+
+# How to report a bug
+
+### Security disclosures
+
+If you find a security vulnerability, do NOT open an issue. I've yet to set up a security email for this so please in the interim DM me on twitter for my email [@timothystiles](https://twitter.com/TimothyStiles).
+
+In order to determine whether you are dealing with a security issue, ask yourself these two questions:
+
+* Can I access something that's not mine, or something I shouldn't have access to?
+* Can I disable something for other people?
+
+If the answer to either of those two questions are "yes", then you're probably dealing with a security issue. Note that even if you answer "no" to both questions, you may still be dealing with a security issue, so if you're unsure, just DM me [@timothystiles](https://twitter.com/TimothyStiles) for my personal email until I can set up a security related email.
+
+### Non-security related bugs
+
+For non-security bug reports please [submit it using this template!](https://github.com/TimothyStiles/allbase/issues/new?assignees=&labels=&template=bug_report.md&title=)
+
+# How to suggest a feature or enhancement
+
+If you want to suggest a feature it's as easy as filling out this [issue template](https://github.com/TimothyStiles/allbase/issues/new?assignees=&labels=&template=feature_request.md&title=), but before you do please [check to see if it's already been suggested!](https://github.com/TimothyStiles/allbase/labels/enhancement)
+
+# How add a recommended VSCode Plugin
+
+Allbase comes with a set of recommended plugins for VSCode. If you have suggestions that will simplify life for the allbase dev community, consider doing a pull-request after modifying `.vscode/extensions.json`. 
+
+# In closing
+
+Thanks, for reading and I'm super psyched to see what you'll do with Allbase!

README.md

@@ -1,9 +1,39 @@
-# allbase
+# Allbase
 
-## All your basepair are belong to us
+## Allbase is a database for engineering organisms
 
-We're building a modern solution to the biotech data access problem. Too many siloed databases using terrible dataformats that can't crossref eachother. Allbase is still in hot development but as it stands now the plan is to have a single service that can search and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot. All sequences get hashes so they have a unique identifier. Allbase should in the end be able to spit out JSON for every sequence it has and every pathway it can make. Keoni should write down how somewhere but search is going to be dummy fast and easy to use through an API.
-## Specification
+* **Comprehensive:** Allbase is a single service that can search, store, and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot
+
+* **Modern:** Allbase serves JSON and is written in Go. Allbase parses legacy file formats so you don't have to.
+
+* **Stable (soon):** Allbase will be well tested and designed to be used in industrial, academic, and hobbyist settings
+
+## Install
+
+Allbase is still in hot development and not production ready. We currently only ships a pre-release dev branch for contributors. Join us!
+ `git clone https://github.com/TimothyStiles/allbase && cd allbase && go test -v ./...`
+
+## Community
+
+* **[Discord](https://discord.gg/Hc8Ncwt):** Chat about Allbase and join us for game nights on our discord server!
+
+## Contributing
+
+* **[Code of conduct](CODE_OF_CONDUCT.md):** Please read the full text so you can understand what we're all about and remember to be excellent to each other!
+
+* **[Contributor's guide](CONTRIBUTING.md):** Please read through it before you start hacking away and pushing contributions to this fine codebase.
+
+## Sponsor
+
+* **[Sponsor](https://github.com/sponsors/TimothyStiles):** 🤘 Thanks for your support 🤘
+
+## License
+
+* [MIT](LICENSE)
+
+* Copyright (c) 2022 Timothy Stiles, Keoni Gandall
+<!-- We're building a modern solution to the biotech data access problem. Too many siloed databases using terrible dataformats that can't crossref eachother. Allbase is still in hot development but as it stands now the plan is to have a single service that can search and cross reference sequences and pathways from genbank, rhea, chembl, and uniprot. All sequences get hashes so they have a unique identifier. Allbase should in the end be able to spit out JSON for every sequence it has and every pathway it can make. Keoni should write down how somewhere but search is going to be dummy fast and easy to use through an API. -->
+<!-- ## Specification
 When completed allbase will have:
 
 * [x] Functions that pull data from Genbank, Rhea, CHEMBL, and Uniprot.
@@ -29,4 +59,4 @@ When completed allbase will have:
     * [ ] Alignment (will be implemented in Poly).
       * [ ] BWA
       * [ ] minimap2
-  * [ ] Insert user provided sequences.
+  * [ ] Insert user provided sequences. -->