How to BurrowCraft

BurrowCraft is a repeatable way to write better posts and better replies. It is not about pretending to be formal. It is about taking the extra minute to make your contribution clear, useful, and worth answering.

1. Know the purpose. Decide whether you are asking a question, making an argument, sharing news, reporting a problem, teaching something, starting a discussion, or answering one specific person.
2. Choose the right group. Put the post where the people who care about that subject are most likely to find it. A well-placed post gets better replies.
3. Write the title last if needed. If you are starting a thread and the title is weak, finish the post first, then come back and write a title that says exactly what the thread is about. If you are replying, keep the reply tied to the thread and the comment you are answering.
4. Open with the point. The first paragraph should tell readers why the post or reply exists. Do not make them dig through five paragraphs to find the subject.
5. Add useful context. Include the facts, links, examples, code, dates, quoted line, or background that someone needs in order to reply intelligently.
6. Shape the post for reading. Use short paragraphs, lists, quotes, and code blocks when they help. Break up long thoughts so the post or reply can be scanned without losing meaning.
7. Proofread before posting. Fix spelling, grammar, broken links, missing words, repeated words, and unclear sentences. Spell check is part of the craft, even for short replies.
8. End with a door open. Give readers something to answer: a question, a next step, a request for evidence, or a clear position they can agree with or challenge.

A BurrowCrafter treats writing like a small performance: prepare the thought, make it readable, check the details, then send it when it is ready.

A good post or reply is not just typed. It is shaped. Before sending it, decide what the reader should walk away understanding, questioning, or doing. If the reply is only a reaction, slow down until it becomes a contribution.

BurrowCraft does not mean sounding fancy. It means respecting the thread, the group, and the people reading. Use plain words. Make the point visible. Cut the fog.

The title is the doorway. It should tell people what the post is actually about. Avoid titles like “Question” or “Thoughts?” when a clearer title is available.

Better: “Why rb.alt.cryptids needs separate field-report threads” or “Testing Markdown code blocks in rb.comp.lang.python.”

Start with the point. Add context. Then give details. End with a clear question, conclusion, or next step. Paragraphs are your friend. A wall of text asks the reader to do your editing.

Use lists when comparing items. Use quotes only when needed. Use Markdown code blocks for code or logs. If a post has several ideas, give each idea room to breathe.

A reply should make the thread easier to follow, not harder. Before replying, make sure you know which point you are answering and who you are answering. If the thread has several branches, stay in the right branch.

Quote only the part that matters. A short quoted line gives context. A giant quoted block makes people hunt for your actual reply. If you disagree, name the claim you disagree with, then explain why.

• Answer the strongest version of what the other person said.
• Add information, evidence, experience, a correction, or a clearer question.
• Keep one reply focused on one main point when possible.
• Use "I think" or "my read is" when you are interpreting, not proving.
• When a reply changes the subject, start a new thread instead of derailing the old one.
• If the other person already corrected themselves, do not keep arguing with the old mistake.

A BurrowCrafted reply does not need to be long. A three-sentence reply can be excellent if it is clear, accurate, and moves the discussion forward.

A BurrowCrafter rereads before posting or replying. Fix obvious spelling mistakes. Check names, links, dates, and group names. Make sure the subject line matches the body.

Read the post once for meaning and once for mechanics. If a sentence fights you, rewrite it. If the post or reply is heated, wait a minute and read it again before sending.

A strong signature can give your posts a little identity, but it should stay short. Think of it as a calling card, not a second post attached to every message.

Keep it well written, readable, and modest. A name, handle, short line, project link, or simple quote can work. Avoid huge banners, long lists of links, repeated slogans, or anything that makes every reply harder to read.

Professional does not mean boring. It means controlled. You can be funny, sharp, skeptical, passionate, or strange while still being readable and fair.

Attack the claim, not the person. Ask better questions. Admit uncertainty. Give sources when sources matter. The strongest post is often the one that stays calm while making a clear case.