#styleguide — Public Fediverse posts

New (to me) #stylesheet [ETA: I mean #StyleGuide, of course; what am I writing? A blig post?] has just dropped:

Numbers
Written out up to and including ninety-nine (however 14 million etc.); commas in thousands.

#AcademicWriting

New post: Maintaining consistency in content and styling

https://chrissmith.xyz/blog/2026/maintaining-consistency-in-content-and-styling/

Looking at ways of getting things like casing consistent and then keeping it consistent.

#webdev #designsystem #styleguide #html #css

"Vale MCP Server

A Model Context Protocol (MCP) server that integrates Vale prose linting into AI coding assistants like Claude Code and Gemini command-line tool.

Overview

This MCP server provides AI assistants with the ability to check files for style and grammar issues using Vale's powerful linting engine. It automatically discovers Vale configuration files and provides formatted, actionable feedback about writing quality.

Features

✅ File linting: Check any text file for style issues with Vale.

🔍 Smart config discovery: Automatically finds .vale.ini files using Vale's native upward search.

🎯 Configuration priority: Supports VALE_CONFIG_PATH environment variable for explicit config.

📊 Rich formatting: Returns markdown-formatted results with emojis and severity grouping.

🛡️ Graceful degradation: Provides helpful installation guidance when Vale isn't installed.

🐛 Debug mode: Optional debug logging for troubleshooting."

https://github.com/theletterf/vale-mcp-server

#Vale #Linting #Markdown #TechnicalWriting #DocsAsCode #SoftwareDocumentation #MCP #MCPServer #StyleGuide

Reading a university style guide that recommends "eleven year-old children".

This does not mean what they think it means, but on the plus side it could lead to some wildly amusing data.

#punctuation #hyphens #writing #StyleGuide #language #orthography

Style guide news!

Do you write C code for CPython itself?

PEP 7 (Style Guide for C Code) has been updated to allow putting newlines before operators, "Knuth style":

if (type->tp_dictoffset != 0
&& base->tp_dictoffset == 0
&& type->tp_dictoffset == b_size
&& (size_t)t_size == b_size + sizeof(PyObject *))
{
return 0;
}

This is similar to PEP 8 and Black style for Python code.

https://github.com/python/peps/pull/3931/files

https://peps.python.org/pep-0007/#code-lay-out

#Python #PEP7 #PEP8 #StyleGuide #KnuthStyle

I was not expecting this footnote in the new Chicago Manual of Style. Thank you, editors of #CMOS18, for modeling #ConsciousLanguage.

"5.255: Making Conscious Choices…Here we draw on the term 'conscious language' as used by Karen Yin, founder of the Conscious Style Guide website." ❤️

#AmWriting #AmEditing #WritingCommunity #StyleGuide #StyleGuides #Copyediting #ConsciousStyle

Hi, #ReadingCommunity! If you liked The #ConsciousStyleGuide, please consider reviewing it. Reviews help others discover my book and can raise its visibility on these platforms. A review can be a few lines—an impression, a takeaway, how it is useful, who should read it.

Boosts are greatly appreciated. Xie xie! 📚

• Amazon (ad): https://amzn.to/3rz6RHx
• Goodreads: https://www.goodreads.com/book/show/198493666-the-conscious-style-guide
• Barnes & Noble: https://www.barnesandnoble.com/w/the-conscious-style-guide-karen-yin/1144029921

#WritingCommunity #StyleGuide #ConsciousLanguage #Inclusion

How Do You Choose Python Function Names? – Real Python

Rules and conventions for naming Python functions emphasizing:
➡️the importance of using descriptive, snake-case names.
➡️the use of underscores for internal methods
➡️differences in naming conventions for variables and classes.

The article is based on Python Enhancement Proposals PEP8

#Python #NamingConventions #CodeReadability #StyleGuide #Programming #Tutorial

https://realpython.com/python-function-names/

What a wonderful review, by @ecbrenner, of @karenyin's new book, The Conscious Style Guide! https://tinyurl.com/2aenpun8 #AmEditing #StyleGuide #ConsciousLanguage #editors #writers

https://www.eventbrite.ca/e/the-greg-younging-conversation-virtual-registration-tickets-887795368847 Wed, May 8, 2024 3:45 PM - 5:00 PM EDT “2024 marks the fifth anniversary of the passing of Greg Younging. We are very pleased to host this year's guest Lorena Sekwan Fontaine, Head of Indigenous Studies at the University of Manitoba and cousin to Greg who will be in conversation with SFU Indigenous scholar, Deanna Reder at this year's Conversation. Join us in person or online as Lorena talks about her ongoing work on the new edition of Greg's seminal work The Elements of Indigenous Style.”

@indigenousauthors #editor #writing #WritingCommunity #StyleGuide #IndigenousMastodon #NativeMastodon #editing #publishing #IndigenousStudies

“The Montréal Effect: Why Programming Languages Need A Style Czar”, Adam Gordon Bell (https://earthly.dev/blog/language-style-czar/).

On HN: https://news.ycombinator.com/item?id=39715223

On Lobsters: https://lobste.rs/s/ngdrbc/montreal_problem_why_programming

#Programming #Style #StyleGuide #Montréal #Scala #Python #Go #Uniformity #Diversity

Oh, no! Someone wanted to keep "one space vs two spaces after a period" alive.

In a 2018 study... Evidently, people read faster with two spaces after a period.

NOTE: The APA changed to "one space" in 2019.

And I'm still trying to break that deeply ingrained habit from high-school typing.

https://link.springer.com/article/10.3758/s13414-018-1527-6

#StyleGuide #Readability #Debate #TwoSpaces

The Atlantic published a bad critique of conscious language style guides. @EvilJoeMcVeigh takes them to task: https://andreadallover.com/2023/08/04/george-packer-and-the-atlantics-sad-defense-of-inequity/

#EnglishUsage #language #linguistics #StyleGuide #ConsciousLanguage #WritingCommunity #EditingCommunity

What a delightfully-irreverent guide to #writing in #English - if you're a fan of #PoliticsAndTheEnglishLanguage by #GeorgeOrwell or of the #ElementsOfStyle by #StrunkAndWhite, brace yourself:

"How To Write English Prose", The Lamp (https://thelampmagazine.com/blog/how-to-write-english-prose).

#Style #StyleGuide

What a delightfully-irreverent guide to #writing in #English - if you're a fan of #PoliticsAndTheEnglishLanguage by #GeorgeOrwell or of the #ElementsOfStyle by #StrunkAndWhite, brace yourself:

"How To Write English Prose", The Lamp (https://thelampmagazine.com/blog/how-to-write-english-prose).

#Style #StyleGuide

What a delightfully-irreverent guide to #writing in #English - if you're a fan of #PoliticsAndTheEnglishLanguage by #GeorgeOrwell or of the #ElementsOfStyle by #StrunkAndWhite, brace yourself:

"How To Write English Prose", The Lamp (https://thelampmagazine.com/blog/how-to-write-english-prose).

#Style #StyleGuide

Hackaday Links: July 19, 2020 - Care to flex your ethical hacker muscles? The Defense Advanced Research Projects Agency, better kn... more: https://hackaday.com/2020/07/19/hackaday-links-july-19-2020/ #hackadaycolumns #ethicalhacking #hackadaylinks #narcoantenna #codingstyle #terminology #transceiver #styleguide #astronomy #exoplanet #svalbard #antenna #redteam #cartel #github #darpa