edit hip in browser walkthrough #1336
Conversation
There was a problem hiding this comment.
As much as I want to love the screen recordings, they kinda make me feel a little seasick. Certainly happy to yield to other opinions on this. However the payload size is a little concerning (sneaking up on 200mb for this page).
The content looks good. Is this guide meant to encourage the broader community to submit changes to HIPs or is it geared more toward the HIP author? It might be worth noting to the reader of this doc that if they aren't the author of the HIP, they should engage in the conversation on Discord.
Maybe further note that editing HIPs which have already been voted on is discouraged.
I'd love to back off on the dependence on admonitions. I find them to be jarring to the reading experience (hard to focus on what is important to read when there are many).
|
followup, I think the load of the gifs keeps crashing the tab in Safari |
Co-authored-by: Joey Hiller <[email protected]>
…/docs into sg/writing-hips-on-github
if its any consolation, I mistakenly made these on my 5k display and one was nearly half a gig when I started 😱 valid points all around. going to pull the gifs and replace with annotated images. Working on a walkthrough video to accompany this tutorial in the future as well |
good call out, Id like to find a nice format for the "key take aways" for each doc page, using the "tip" green admonition as a standing for now |
the immediate need is for the IOT PoC Working group looking to make edits, like, today. but capturing this as an issue to revisit later #1342 |
No description provided.