The Hub is a Jekyll-based website that helps 18F organize its internal information and explore the connections between team members, projects, and skill sets. It takes less than a minute to set up a hands-on demo, which we hope will inspire other teams to develop their own Hubs, publish snippets, and organize working groups.
The Hub serves as the go-to place for all team-internal information, whether that information is integrated into the Hub directly or provided as links to Google Drive documents, Google Sites, GitHub READMEs and microsites, Slack conversations, etc.
- Main internal Hub: https://hub.18f.us/
- Public Hub staging area: https://hub.18f.us/hub/
- Main Git repository: https://github.com/18F/hub
The primary maintainer (for now) is @mbland. The goal is to eventually hand ownership over to the Documentation Working Group as a whole.
You will need Ruby ( > version 2.0 is a good idea). You may also consider using a Ruby version manager such as rbenv to help ensure that Ruby version upgrades don't mean all your gems will need to be rebuilt.
$ git clone git@github.com:18F/hub.git
$ cd hub
# Initialize the _data/public and _data/private submodules
$ git submodule init
$ git submodule update --remote
# If bundler isn't yet installed
$ gem install bundler
$ bundle
$ bundle exec jekyll serve
By default this will build the site in "private mode", whereby information from _data/private is incorporated. To build in "public mode" so that this information doesn't appear:
$ bundle exec jekyll serve --config _config.yml,_config_public.yml
In addition to this README, there is also:
- Deployment README - DevOps details: publishing the generated site; AWS; Nginx; SSL; Google Auth Proxy
- Plugins README - Development details: data import and joining; canonicalization; cross-referencing; page generation
- Data README - Details regarding the organization and processing of data.
Just fork 18F/hub and start sending pull requests! Feel free to ping @mbland with any questions you may have, especially if the current documentation should've addressed your needs, but didn't.
This project is in the worldwide public domain. As stated in CONTRIBUTING:
This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.
All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.