Communities

Writing
Writing
Codidact Meta
Codidact Meta
The Great Outdoors
The Great Outdoors
Photography & Video
Photography & Video
Scientific Speculation
Scientific Speculation
Cooking
Cooking
Electrical Engineering
Electrical Engineering
Judaism
Judaism
Languages & Linguistics
Languages & Linguistics
Software Development
Software Development
Mathematics
Mathematics
Christianity
Christianity
Code Golf
Code Golf
Music
Music
Physics
Physics
Linux Systems
Linux Systems
Power Users
Power Users
Tabletop RPGs
Tabletop RPGs
Community Proposals
Community Proposals
tag:snake search within a tag
answers:0 unanswered questions
user:xxxx search by author id
score:0.5 posts with 0.5+ score
"snake oil" exact phrase
votes:4 posts with 4+ votes
created:<1w created < 1 week ago
post_type:xxxx type of post
Search help
Notifications
Mark all as read See all your notifications »
Q&A

General Q&A about the craft of professional writing, editing, and publishing. Questions about all types of writing are welcome -- fiction, technical documentation, scholarly articles, poetry, scriptwriting, blogs, and more.

Filters (None)
66%
+2 −0
How do I know when I should rewrite vs. editing my first chapter

A little context for my question... A long time a go, I started writing little vignettes for a character I was playing in an RPG group. The vignettes ended up joining up and becoming sort of a ba...

3 answers  ·  posted 9mo ago by pureferret ‭  ·  last activity 2mo ago by Michael‭

25%
+0 −4
Should writers shun cognate stems that share roots, because readers take longer to process these stems? [closed]

Question 1 Here I am asking about merely reading and writing. Do human readers take longer to distinguish between stems (and bases) that share the same root, even if merely picoseconds? For exa...

0 answers  ·  posted 1y ago by TextKit‭  ·  closed 1y ago by Canina‭

40%
+0 −1
Want to Expand my Writing Career as Freelancer [closed]

I've been working as a content writer and blogger for a few local agencies. I want to start freelancing this year but am slightly afraid to start. Could anyone help me how to start freelancing as a...

0 answers  ·  posted 1y ago by proptijohn‭  ·  closed 1y ago by Mithical‭

66%
+2 −0
Sphinx: API documentation: How to turn off creating links to Parameter/Argument link creation

For projects with API documentation generated by Sphinx, I've noticed that some project's don't include links to the Parameter/Argument types (str, file-like object, int, etc) and some projects do....

0 answers  ·  posted 1y ago by CodeFarmer‭  ·  last activity 29d ago by Mithical‭

80%
+6 −0
What is the Current State-of-the-Art / Any Successful Experiements with EPUB Format?

As a zipped web-page, EPUB has long offered the possibility of completely changing how a book looks and feels with dynamic content and interactive content. But since EPUB came out (2007), I really...

3 answers  ·  posted 2y ago by James McLellan‭  ·  last activity 1mo ago by ArtOfCode‭

22%
+0 −5
Why didn't 18-19th century Anglophone authors shorten their sentences, by starting more with Majuscules? Why lengthen them with comma + conjunction? [duplicate]

Shorter sentences have been proven more readable. Thus why didn't the authors below sunder their lengthy sentences, prolongated by comma + conjunction? Why not divide them into shorter sentences s...

0 answers  ·  posted 2y ago by TextKit‭  ·  edited 2y ago by TextKit‭

30%
+1 −5
Why didn't 18-19th century Anglophone authors shorten their sentences, by starting more with Majuscules? Why lengthen them with commas, (semi)colons?

Shorter sentences have been proven more readable. Thus why didn't the authors below sunder their lengthy sentences, prolongated by commas and (semi)colons? Why not divide them into shorter sentence...

0 answers  ·  posted 2y ago by TextKit‭  ·  edited 2y ago by TextKit‭

81%
+7 −0
What is the correct way to mark a section as a translation?

I am often in the situation where I would like to cite a source in another language, and as such include my own translation alongside the quotation. I have been told that translation is a form of ...

1 answer  ·  posted 2y ago by Moshi‭  ·  last activity 7d ago by Mithical‭

77%
+5 −0
How can garden path sentences be used (and misused)?

"A garden path sentence is a grammatically correct sentence that starts in such a way that a reader's most likely interpretation will be incorrect; the reader is lured into a parse that turns out t...

1 answer  ·  posted 2y ago by Paul A. Clayton‭  ·  last activity 2y ago by gmcgath‭

66%
+2 −0
Need basic tools and ways to practice and polish my writing skills

What are the ways to practice and improve basic writing, like content and creative writing? I am not planning to write or learn to write fictional stories. By creative writing, I mean the essentia...

3 answers  ·  posted 2y ago by Michael16‭  ·  last activity 9mo ago by tripleee‭

28%
+0 −3
Why closed questions tend not to get reopened? [closed]

This post is about Q&A websites in general. In StackExchange there is a culture of closing questions which do not reflect "the standards"; it's a culture that I as someone who uses SE since 20...

0 answers  ·  posted 2y ago by deleted user  ·  closed 2y ago by Canina‭

80%
+6 −0
HTML tags versus CSS classes: is one preferred over the other for the same styling?

We publish documentation online using HTML. For things like fixed parameter names and other code literals, we use <code> tags. My question is about styling these in tables. On our referenc...

2 answers  ·  posted 2y ago by Monica Cellio‭  ·  last activity 2y ago by Canina‭

71%
+3 −0
How can we integrate a lightweight public ticketing system into our documentation feedback form?

We publish a substantial documentation set online. Each page has a place at the bottom that asks "was this helpful? (Y/N)", and if the person chooses "no" we offer a textbox. We collect all this ...

3 answers  ·  posted 2y ago by Monica Cellio‭  ·  last activity 16d ago by Monica Cellio‭

60%
+1 −0
For starting a blog, is a niche blog or general/misc content better?

I am thinking of starting a blog and wondering how I should approach it. Is it better to have a niche blog or is general/miscellaneous content fine?

5 answers  ·  posted 3y ago by yashikaissrani‭  ·  last activity 4mo ago by Mithical‭

66%
+2 −0
Do readers primarily identify with or judge heroes in a novel?

In this article about different categories of heroes, Matt Bird states that sensitive and unlucky heroes are hard to write because audiences have a hard time caring about them. He says: American...

1 answer  ·  posted 3y ago by icanfathom‭  ·  edited 1mo ago by Michael‭

60%
+1 −0
In 2021, which publishers distribute novellas?

The Hugo awards are prominent fan awards in the SF&F genre. In 2021, I noticed that all of the finalists in the Novella category are from a single publisher, Tor.com. Novellas have, I underst...

2 answers  ·  posted 3y ago by Monica Cellio‭  ·  last activity 3y ago by Mark Baker‭

71%
+3 −0
How do I brainstorm for writing positively about myself?

I've always struggled writing about myself, but I need to apply for a program and the application has a lot of very broad but personal questions like, Tell us why you would be a good leader Exp...

2 answers  ·  posted 3y ago by Sigma‭  ·  last activity 3y ago by Monica Cellio‭

75%
+4 −0
What is the possessive form of et al.?

When referring to a paper with multiple authors by using the name of the first author and "et al.", how does one indicate possession? For example, is it correct to write, "Einstein et al.'s paper ...

3 answers  ·  posted 3y ago by BR11‭  ·  last activity 1mo ago by ArtOfCode‭

60%
+1 −0
How do we prevent Madcap Flare from injecting non-breaking spaces in our documentation?

We use Madcap Flare for our documentation, and it has an annoying property: if you happen to have the shift key down when you type a space, it inserts a non-breaking space (&#160;). Our docume...

2 answers  ·  posted 3y ago by Monica Cellio‭  ·  last activity 2mo ago by Mithical‭

40%
+0 −1
When else ought you introduce new material in a final paragraph?

Are there any other "times" for introducing new content into a final paragraph? Have any other famous writers substantiate this bombshell? I was flabbergasted to read this para. because mo...

1 answer  ·  posted 3y ago by TextKit‭  ·  last activity 2mo ago by Monica Cellio‭

60%
+1 −0
How would you pop the reference to a minor case into the ‘Application' section of an essay?

I don't understand the example emboldened below. Can't you add just a superscript number in the text, then in the footnotes cite that "minor case"? Unquestionably one superscript cannot "detract fr...

0 answers  ·  posted 3y ago by TextKit‭

law
66%
+2 −0
What are some ways to encourage team members to contribute and maintain a centralized wiki?

I joined my current company and department a few years ago. We had some documentation for processes but most people had been around for a long time and never needed it, so it was very sparse. Sinc...

3 answers  ·  posted 3y ago by Sigma‭  ·  last activity 3y ago by Mark Baker‭

60%
+1 −0
How do we get Flare to stop modifying .gitignore?

We use Madcap Flare for our documentation, and the project is checked into git. (In case this matters, this is a locally-hosted git server, not GitHub.) The project uses a .gitignore file to aver...

1 answer  ·  posted 3y ago by Monica Cellio‭  ·  last activity 3y ago by Monica Cellio‭

77%
+5 −0
Technical Writer Skill Set

As technology and industry demands evolve, what tools/skills should one focus on learning/improving as a technical writer?

2 answers  ·  posted 3y ago by yashikaissrani‭  ·  last activity 1mo ago by ArtOfCode‭

50%
+0 −0
Help! Editing Tips? [closed]

Hey, I'm having trouble editing my book. I have a crime novella but I can't edit that well. Does anyone have any tips to help? Thanks! ~Rosewood

0 answers  ·  posted 3y ago by Rosewood‭  ·  closed 3y ago by Monica Cellio‭

60%
+1 −0
block-quotation narrative with dialogue

Over on the Judaism site, I summarized a narrative text in a block quotation. Because the narrative is well-known, I expected many people to skip the block quotation; therefore, I did not want it t...

2 answers  ·  posted 3y ago by msh210‭  ·  last activity 2y ago by Mark Baker‭

71%
+3 −0
Syntax summaries use brackets for optional elements; how do I represent literal brackets in a way readers will understand?

In our documentation of SQL functions and statements, we include a BNF-style syntax summary. As is conventional, we indicate optional elements in square brackets, like this: CREATE [IF NOT EXISTS]...

4 answers  ·  posted 3y ago by Monica Cellio‭  ·  last activity 3y ago by Derek Elkins‭

77%
+5 −0
Is there any benefit when writing out instructions to split it up into lots of little paragraphs, or is it better to leave it in one paragraph?

I was putting together an instruction page (for setting up a game that my business created), which included a whole lot of various pointers, most of which were only a sentence or two long. These ex...

3 answers  ·  posted 3y ago by Mithical‭  ·  last activity 3y ago by Mark Baker‭

75%
+4 −0
Which parts of a character's plan should be revealed beforehand?

Two characters (one is a PoV character) come up with a plan to break a third out of prison. They succeed, with only minor complications. If I describe too many details of their plan beforehand, it ...

2 answers  ·  posted 3y ago by Evil Sparrow‭  ·  last activity 3y ago by Razetime‭

66%
+2 −0
How to determine relative success of different, similar books published by different means?

This answer discusses how to choose between traditional print publishing, ebook publishing, self publishing, etc., and concludes by stating that You should publish your book using the channel wher...

1 answer  ·  posted 3y ago by Canina‭  ·  last activity 3y ago by msh210‭

66%
+2 −0
What is the main publishing format authors should be using today?

I've recently begun investigating the publishing process, and what I as an author need to do to get my book read. I'm aware of the self-publishing option, but as I have not studied any options exte...

1 answer  ·  posted 3y ago by Thomas Myron‭  ·  last activity 3y ago by Mark Baker‭

66%
+2 −0
How to keep track of worthwhile snippets from discovery writing, which don't work where they were first written?

Sometimes, when I write, I find myself writing down a path that ends up not leading at all where I wanted to go with what I was writing. That's to be expected when discovery-writing. Depending on t...

1 answer  ·  posted 3y ago by Canina‭  ·  last activity 3y ago by Mark Baker‭

66%
+2 −0
How can we format code examples so that they work on a range of devices?

We use Madcap Flare to produce a large documentation set that contains many code examples (primarily SQL, but also C++, Java, and Python) and command-line operations. When the doc set was first pl...

1 answer  ·  posted 3y ago by Monica Cellio‭  ·  last activity 3y ago by manassehkatz‭

77%
+5 −0
How to ask for permission to use readers' endorsements?

I have a blog with long, analytic articles. Because of their nature, they don't really attract much clicks. However, once people distill it thoroughly, many of them express that the articles are in...

1 answer  ·  posted 3y ago by Ooker‭  ·  last activity 3y ago by Mark Baker‭

84%
+9 −0
Is writing policy pages in a lighthearted manner harmful in any way?

Recently, I threw together a draft of a policy page about promotional content, with some guidelines on what to keep in mind to avoid spamming. (Incidentally, this is for Codidact itself.) I decided...

2 answers  ·  posted 4y ago by Mithical‭  ·  last activity 4y ago by Mark Baker‭

66%
+2 −0
How to train readers in Argot or Slang

I have a character which is typical street thug, criminal and did his time in jail. He is using a lot of underground Argot and thug slang. Example below At the end we got the ice, gravy train if y...

1 answer  ·  posted 4y ago by Prahara‭  ·  last activity 4y ago by Canina‭

66%
+2 −0
Using accents while staying legible

My character is using a hardly legible accent, or simply an accent which is not comfortable for a reader to read. For example: “Ye've caught us in th' middle o' supper. Seein' as how yer no bleedi...

2 answers  ·  posted 4y ago by Prahara‭  ·  last activity 1mo ago by ArtOfCode‭

77%
+5 −0
Everyone's a woman: how do you show that through gender-neutral language?

In my latest short story I'm playing around with common gender misconceptions. It's set in a near future society were men have disappeared, and all roles are taken up by women. The theme is played ...

1 answer  ·  posted 4y ago by Liquid‭  ·  last activity 4y ago by Prahara‭

71%
+3 −0
Dealing with Audience's expectations

Over the years I gained small audience and I love them. My last work quite disappoint them in regard of one character and I feel bad about it. I felt like character's struggle she went through woul...

2 answers  ·  posted 4y ago by Prahara‭  ·  last activity 4y ago by Liquid‭

75%
+4 −0
Writing "light hearted" lead characters

For some reason, when I find myself writing a male protagonist, I seem to default to the brooding, gritty kind of man that could easily find his place into a noir novel. Those characters are often ...

2 answers  ·  posted 4y ago by Liquid‭  ·  last activity 4y ago by Prahara‭

75%
+4 −0
Action scene pacing and clarity

I am using, for action scenes, this three act format which allows me to control pacing and create order in hectic environment: Action - analysis - reaction Johann fired (action) his pistol and mi...

1 answer  ·  posted 4y ago by Prahara‭  ·  last activity 4y ago by Mark Baker‭

66%
+2 −0
In a young adult, what would cause development of a high sense of duty?

This is a question related to my previous question about child's morality, but different criteria are applied. Criteria and Question: My desired kid would be born commoner but from merchant class, ...

2 answers  ·  posted 4y ago by Prahara‭  ·  last activity 4y ago by gymbrall‭

71%
+3 −0
Could a 13-year-old have morality to disagree with their family's unethical business practices, while those are the norm in their society?

I am very bad at writing children characters in my stories, I always make them either too "dumb" or too developed. Currently I am in need of believable child +- 13, boy or girl. Requirements: My de...

2 answers  ·  posted 4y ago by Prahara‭  ·  last activity 4y ago by Monica Cellio‭

84%
+9 −0
How can I pinpoint a story's moral dilemma?

In this answer, Mark Baker makes a statement about story: All story ideas are basically a variation on one thing. A man (or woman, or child, or small furry animal) has two desires, both of which h...

4 answers  ·  posted 4y ago by icanfathom‭  ·  last activity 4y ago by DPT‭

75%
+4 −0
How to show powerful emotion in a character trying to hide it?

This question deals with showing the emotions of characters when those characters are actively trying to hide their emotions. If the emotion is something subtle, like apprehension or annoyance, you...

3 answers  ·  posted 4y ago by Thomas Myron‭  ·  last activity 4y ago by Prahara‭

60%
+1 −0
How can I make a character sound condescending?

In one chapter, the PoV character meets up with her sister. Her sister is supposed to be fairly stuck-up and thinks she's a complete lowlife, so she talks down to her the whole time. I have the Po...

2 answers  ·  posted 4y ago by Evil Sparrow‭  ·  last activity 4y ago by Canina‭

71%
+3 −0
Are speaker tags always necessary when multiple people are in the conversation?

I understand that if you’ve got two people speaking, you often don’t need speaker tags because it’s assumed that both people take it in turns unless otherwise specified. This keeps the conversation...

2 answers  ·  posted 4y ago by Mousentrude‭  ·  last activity 4y ago by Mark Baker‭

80%
+6 −0
"The tale how" vs. "The tale of how"

My SO and I were discussing the following sentence in his writing: This is the tale how once the Septemi helped King Nicodemus subdue walking firestorms, how we hunted cultists and mongrelfolk i...

2 answers  ·  posted 4y ago by Sigma‭  ·  last activity 4y ago by xtal‭

81%
+7 −0
mice don't tap and tablet-users don't click: what word can I use for all audiences instead?

I am documenting features on a web site. The audience is end users, who could be anywhere from seasoned Internet veterans to relatively new people who came for my site's content but aren't general...

4 answers  ·  posted 4y ago by Monica Cellio‭  ·  edited 3y ago by Canina‭

71%
+3 −0
How can I make a transition from third person omniscient to first person less jarring for the reader?

I'm working on a longish short story (I expect to hit somewhere around 5,000 - 6,000 words by the time I'm through) that starts out in third person omniscient POV, mostly because that allows me to ...

2 answers  ·  posted 4y ago by Canina‭  ·  last activity 4y ago by Monica Cellio‭