Skip to content

Conversation

@vito
Copy link
Member

@vito vito commented Mar 18, 2021

related to (& dependent on, for some of the links) concourse/rfcs#97

  • adds a table of the top 10 most popular RFCs (by github reactions)
  • call-to-action for feedback and deep-links to open questions within RFCs
  • replaces the manual RFC round-up blog posts process; hopefully directs a lot more traffic to the RFCs

i'd include a screenshot but it's a little janky due to the fixed background image position - try it out with ./scripts/build -s 3000!

@vito vito changed the title add RFCs table to front page add RFCs table to front page, + 2021 community survey banner Mar 18, 2021
@vito
Copy link
Member Author

vito commented Mar 19, 2021

rebased to split the community banner into #411 (though these changes are still on top of it)

@vito vito changed the title add RFCs table to front page, + 2021 community survey banner add RFCs table to front page Mar 19, 2021
vito added 9 commits March 19, 2021 11:32
no reason in particular, just getting onto a proper tag

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
ended up not using this, but it may be useful in the future

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
pretty sure this fixed weirdness with go 1.16

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
* switch to GitHub GraphQL API
  * $GITHUB_TOKEN is now required
* fetch top RFCs at build time
  * cached so it doesn't happen all the time in server mode
* show number of open questions for each RFC
* sort RFC table by reactions to focus-fire feedback on the most popular
  RFCs so we can resolve them more quickly

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
prevents word-wrapping, and matches github emoji font size (...i think)

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
vito added 2 commits March 22, 2021 21:26
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
* rename local GitHubRelease type so it doesn't look exported
* just don't use a pointer
* skip draft releases, too
* move 'no releases' check to the end (since pre and draft releases
  should count as 'no releases')
  * ...not that any of this really matters, since we've, like, released
    already

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
@vito vito requested a review from taylorsilva March 23, 2021 15:24
Copy link
Member

@taylorsilva taylorsilva left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!
image

Only thing that makes me go 🤨 is the way the number of open question are displayed. On first viewing I thought it was a font error, like it was trying to display an unknown character. I actually only understood what it meant because I have context on the format of RFC's. I don't think this will be obvious to people seeing it for the first time and not being familiar with our RFC format. Maybe @matthewpereira has a better idea of how to represent "number of open questions" in a succinct way? Maybe it should be it's own column called "Open Questions"?

Shouldn't block this pr, but I wanted to discuss it before approving.

@taylorsilva
Copy link
Member

Excuse the hacky formatting, playing around in the browser, adding open q's as a column
image

@vito
Copy link
Member Author

vito commented Mar 24, 2021

@taylorsilva What happened with the background image at the top there? 😆

And yeah I struggled with the open questions representation for a bit. It had its own column at one point, but I opted to bring it closer to the proposal since it's a sub-heading of it. Here's a cheap attempt that swaps the "?" for an acronym (yay), "OQ":

image

(Also that's what the header's supposed to look like - does it work for you or was that just a weird screenshot?)

@taylorsilva
Copy link
Member

lol yeah firefox messed up the screenshot! it looks fine for me, same as what you're seeing.

Gonna approve now, maybe someone will think of something better later.

vito added 2 commits March 25, 2021 17:09
Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
also update link for submitting feedback (section was renamed)

Signed-off-by: Alex Suraci <suraci.alex@gmail.com>
Copy link
Member

@taylorsilva taylorsilva left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@vito
Copy link
Member Author

vito commented Apr 7, 2021

Thanks for the review! Just merged the RFC PR, so merging this no.

@vito vito merged commit 089e560 into master Apr 7, 2021
@vito vito deleted the rfcs-table branch April 7, 2021 17:55
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

Successfully merging this pull request may close these issues.

4 participants