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)
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...
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...
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....
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...
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...
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...
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...
As technology and industry demands evolve, what tools/skills should one focus on learning/improving as a technical writer?
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...
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 ...
"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...
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...
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...
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...
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 ...
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...
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...
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...
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...
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...
Every time I write and read the 'she's and the 'he's especially in the same paragraph it confuses me and that worries me if the readers will get confused. Obviously through different actions and d...
Sometimes exposition is just necessary. Although there's plenty of youtube videos with examples in films of exposition done right, I'm struggling to find good examples of written exposition. I te...
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...
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 ...
can anyone tell me whether the written Chinese name should be in the order of "surname + given name", or another way around? And of course, in academic writing. I am a PhD student in Bristol, I rec...
Is it ever acceptable to use an exclamation mark following a question mark? I am proofreading a novel and have been instructed to make no stylistic changes, only errors that impede sense/clarity. ...
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...
Sorry if this question has been asked a lot I've been writing for a year now and have used both Google docs and Evernote and found them both to be lacking Google docs: I'm a writer who likes to f...
I am a discovery writer. I wrote more than 50% of my first novel's first draft. I got really confuse about some aspects of writing, so I took a break and analysed my plot. I've started developing...
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...
Note: This question deals exclusively with personal stakes (what the character could lose). It does not deal with public stakes (what the world of the novel could lose). In my mind, there are t...
As a writer, I used to write short stories and poems. As a reader, fantasy is my favorite genre. I created some what of a language for my (first ) novel. It's phoneme, pronunciation, rules and ...
Some of my characters have little to no education, and I'm looking for ways to show that through their dialogue. (They're uneducated, but not necessarily stupid.) Here's what I've tried so far: ...
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...
Is the "very + [noun]" structure, as an emphasis on the noun, formal-enough for an academic paper? For example in the sentence below: "The environment had a significant impact on the state of his ...
In the first discussion of the concept of "plot" given by [1] I, maybe, understood two different, but complementary, concepts of plot. Mckee gives us a definition of Plot as: To PLOT mean to n...
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...
I'm currently in the middle of writing several fantasy books and, even though I'm not done with any of them, I can't stop thinking about how my name will appear on my books once they are finished. ...
As a writer, I used to write short stories and poems. As a reader, fantasy is my favorite genre. And I am currently working on my first novel, an extraterrestrial fantasy thriller. When describing...
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?
As a novice writer to improve my writing I have taken one online course. I want to ask, what are good ways to improve as a writer other than writing courses?
How does a person get an entry on Britannica, Encyclopedia.com etc. ? The person has a Wikipedia page and news references. Thanks!
It would be nice to be a member of an online community of people who are knowledgeable about writing, willing to directly help eachother in a format such as Q&A (like here on SE), but also enga...
I am writing a five-page essay about a novel my literature class has read. I do not want to post my thesis or any snippets of my essay for fear that a plagiarism checker will flag my paper. My pa...
Novice on writing here, except few academic reports. I've got an idea to write a blog about my travel experiences, Although I speak Queen's English, I wish to write this blog for anyone interested...
Two people are dating, and one of them wants to tell the other they are humble, which they genuinely are. But I don't want it to seem like they're bragging or showing off about it. In normal conv...
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...
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...
I wrote a piece of flash fiction as a mental exercise. I happened to listen to Glen Miller’s “Moonlight Serenade,” and happened to watch an episode of “Samurai Jack.” “Moonlight Serenade” is a so...