Coder Social home page Coder Social logo

18f / hub Goto Github PK

View Code? Open in Web Editor NEW
46.0 141.0 33.0 17.02 MB

DEPRECATED: Documentation hub for the 18F team

Home Page: https://github.com/18F/handbook

License: Other

Ruby 15.74% HTML 7.00% CSS 10.84% JavaScript 64.82% Shell 0.78% Python 0.53% Nginx 0.29%

hub's Issues

go serve command fails without submodules

When running
./go serve

after running
./go init

but before initializing the submodules, I get the following:

canonicalizer.rb:90:inblock in sort_by_last_name!': undefined method downcase' for nil:NilClass (NoMethodError)

It works with the submodules.

Visual Indication of Public Hub vs. Internal Hub

@meiqimichelle @elainekamlley @gboone @leahbannon

As we work on making the Hub both a resource for ourselves from the data-private side, we are also making some of it available to the public. From an internal perspective - should we have different designs for each instance so we know which version we're looking at?

Do we need to have some indications on the public hub that this is a public version of things and that some of the items have been redacted? For example, should we call it "18F Public Hub"?

newsclips - where to fit in

I've been keeping a list of 18F news clips in /team-ops, but can move them here. Any preference as to where I put them? I can forklift it as a page onto 18f.gsa.gov/hub easily enough but @mbland, do you have something else in mind?

@OriHoffer, @gboone - any thoughts?

[This is in support of https://github.com/18F/hub-pages-private/issues/3]

Changes/additions to New Hire Pro Tips

While we're transitioning the info from the New Hire Pro Tips doc over to the hub, please use this issue to record and edits or additions you'd like to make. That way, they won't get lost in the cracks! You can also open a new issue in this repo if you like -- whatever works for you :) Thanks!

Search bar should clear on back/forward

Seems like now if you search for something, go to it, and then hit 'back', the search bar is still populated with the original search (which right now means that the page content is blank because of a separate issue).

Add office location API

Once #108 is integrated, as noted in that PR, the longer-term ideal would be to replace the locations array in assets/js/map.js with a call to /api/locations (or /api/locations.json?).

cc: @shawnbot @msecret

data file breaking?

Haven't learned enough about what data is supposed to go where and how so might be off on this, but by chance, are apostrophes breaking the data formatting somehow in the team.yml file?

The github coloration just caught my eye and made me concerned. Notice the all read starting at the apostrophe at the end of aaron's bit and going through to the end of Alison's bit.

screen shot 2015-01-08 at 8 52 26 pm

Scalable data model

In order to support adding multiple teams to a single Hub, we need to rethink _data/private/data-private somewhat.

Already there's the idea that we should split the projects.yml file into separate files. We should probably do the same for team.yml, pif_team.yml, and potentially all of the data files that are basically collections/Arrays of Hashes.

There's also the notion of supporting multiple teams in a single Hub instance. Will start thinking about this; open to ideas.

cc: @meiqimichelle @afeld @gboone @elainekamlley

Improve automation of adding new team members

Right now, the authentication list used to configure access to the Hub is automatically generated by the auth.rb plugin given information in _data/private/team.yml. However, updates to team.yml do not yet trigger an automated deployment to https://hub.18f.us/ and restart of the google_auth_proxy that controls access.

Add intro to hub

Current page does not describe what it is or what people will find there. Add something to gives public a reason to care :)

(I'm mostly thinking about the public version on this -- although would likely be helpful on private version as well)

First page load takes a very long time

Per discussion with @mbland, I ran into a problem where these two links:

have dramatically different load times. The former took over a minute to load (enough that I closed the browser tab twice and reloaded it thinking I had some issue on my end); the latter popped up instantly.

I can't really evaluate how long they take in the shell because both are authenticated, although I could probably shim something up to do that if someone would like.

Mike thinks it may be my connection. At the moment, I have pretty substantially reduced bandwidth (between 10 and 20 kbyte/s, so 1.5-2.8x dialup), which hasn't been an issue, like, at all, for working on github/over ssh.

The reason I mention this is it seems problematic to house policy documents in a place that is hard to get to.

The "hub" pages are as fast as github pages after that initial, very-long pageload.

Create guideline layout

The thought:

  • the Hub backend repos(s) can host all our guidelines (public and private) in markdown
  • the internal Hub frontend needs to layout to consume all of these
  • those markdown files can then also feed whatever else we want to create with them via the Hub API

This issue is to create the layout so we can start hosting our guidelines all in one place. At a very simplistic level, this layout needs:

  • solid typography paragraphs, lists and headings
  • nav for subsections

Discuss.

Implement automated deployment of public Hub

Working with @gboone, the automated deployment environment is largely ready to go, but a couple of items need doing:

  • add mbland's key to the 'site' user on 18f.gsa.gov
  • update the 18f.gsa.gov nginx config to respond to the /hub/deploy webhook on port 4002
  • fab start --set branch=production-public

Revamp team index page

The /team page is currently generated by _plugins/team.rb. Ideally it should be generated straight from a Markdown page in /pages.

add URL to repo description

Sorry if I'm missing anything but it seems like it'd be useful to add 18f.gsa.gov/hub to the repo description. I don't have access or would myself.

add 18f org chart to /hub

When it's at a good point for it, it'd be great to add to /hub.

@quepol - do you want to ping here when it's to that point? Alternatively, if you're game to post the remaining issues, @mbland or I can keep an eye and check in if it looks like they are addressed.

Fix nested list styles

#81 was a quick-fix for unordered list items nested two levels deep, but nested lists beyond that aren't indented properly. Since I haven't been touching any CSS besides assets/_sass/_hub.scss, I need folks with deeper CSS knowledge than I to help fix this.

cc: @afeld @meiqimichelle

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.