18f / hub Goto Github PK
View Code? Open in Web Editor NEWDEPRECATED: Documentation hub for the 18F team
Home Page: https://github.com/18F/handbook
License: Other
DEPRECATED: Documentation hub for the 18F team
Home Page: https://github.com/18F/handbook
License: Other
When running
./go serve
after running
./go init
but before initializing the submodules, I get the following:
canonicalizer.rb:90:in
block in sort_by_last_name!': undefined method downcase' for nil:NilClass (NoMethodError)
It works with the submodules.
@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"?
There are many ways to slice-and-dice our team info:
In the old layout, this was clear. In the new layout, it is not obvious.
Read all links, learn more link
Yo know, ex-out and all :)
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]
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!
Add personal bio info that is currently in our Google Wiki to Hub person pages.
Right now the process works. Reliably. We can automate the collection and processing of the snippets using the Google Data APIs and App Engine for scheduled jobs.
When ready :)
cc @kaitlin
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).
I'm not sure of the best way to fit them in, but imagine it'd be helpful to incorporate them.
Visible focus lost between 'new to 18f' and search
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.
Migrating from 18F/hub-original#23. From the original: We'll start adding some helpful docs to /howto, the first of which being how to add/update docs in /howto via different git clients!
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.
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.
Unnecessary division between the parts of the page.
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)
Works pretty well up to nine characters, but completely stops showing results as of the tenth.
cc: @afeld
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.
On "18F Structure" page, update Where Am I? to reflect:
In order to potentially pitch the Hub to groups that don't use Google-managed domains, we need to investigate how we could potentially use MyUSA for Hub authentication.
Migrated from 18F/hub-original#26. From original issue:
Per @afeld's idea:
The thought:
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:
Discuss.
The layouts in _layouts
used by plugins should be separated into _plugins/layouts
, leaving _layouts
with only layouts used directly by pages in pages
.
cc: @meiqimichelle
Current is the same as internal hub, "18F Internal Team Information Hub"
Working with @gboone, the automated deployment environment is largely ready to go, but a couple of items need doing:
fab start --set branch=production-public
The /team
page is currently generated by _plugins/team.rb
. Ideally it should be generated straight from a Markdown page in /pages
.
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.
On the specialties page (which is awesome, btw) the specialties are sorted alphabetically, which puts the Upper Cased ones first. Either the sort order should be case-insensitive, or we should enforce case in people's specialities.
#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
Per @gboone: Very-Simple-API
Basic idea is, a lot of the current _plugins/api.rb implementation can be stripped out by relying on a stripped-down layout that just pipes data through the jsonify
filter.
then I might spend more time making those great
Something along the lines of:
https://github.com/blog/1939-how-github-uses-github-to-document-github
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.