Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update press release css and add BR 0.1.8 release #1136

Merged
merged 5 commits into from
Sep 5, 2023

Conversation

jholdstock
Copy link
Member

Adds a press release for Bison Relay 0.1.8, as well as reviewing formatting for existing press releases.

Closes #1121

- Reduce size of headers. This means we can use h2/h3 instead of h4/h5.
- Make links white instead of blue.
- Reduce scale of block quotes and add authors.
@xaur
Copy link
Contributor

xaur commented Sep 2, 2023

I find the "long lines" much easier to work with because they are more "responsive" and auto-reflow in editors and less capable Markdown renderers as shown below. Our Press Releases will not be published as GitHub Releases ofc but it is a good example of what happens when the renderer is not smart enough to join the lines. The problem is best shown on more narrow screens. The same happens in the text editor if its window is made smaller than 80 characters wide.

Am I missing out on some benefits of wrapped lines?

gh_wrapped_lines_ugly

@jholdstock
Copy link
Member Author

We've discussed this before, and all of the reasons there are still holding true.

While it's largely a question of personal preference, it also depends on the type of work and tooling. Developer and terminal tools are often optimized to work with a fixed line length (80 characters has been a standard for developers since ~1950s punch-card programming). Publishing and communication tools are usually better equipped to deal with longer lines. GitHub and git are developer tools which are both better at handling fixed line lengths, so I'd argue we should stick with to developer standards.

@xaur
Copy link
Contributor

xaur commented Sep 3, 2023

Thanks for digging that link. I forgot that, it seems my workflow is too different. I wrote up the differences for myself to not forget it again. I'm good with whatever works best for repo maintainers.

@dajohi dajohi merged commit a97f203 into decred:master Sep 5, 2023
2 checks passed
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.

news: Review markdown formatting
3 participants