To write and publish something small, say just a few pages

  • Thread starter symbolipoint
  • Start date
In summary: On Writing Well by William Zinsser is a great resource for learning how to write and publish small, useful documents such as educational materials or recipes. It provides clear and concise guidance on how to write in a clear and understandable manner. While a technical writing course may be helpful, reading and analyzing good writing examples and learning from them can also be effective. Ultimately, the goal should be to produce useful material rather than focusing on selling or making money.
  • #1
symbolipoint
Homework Helper
Education Advisor
Gold Member
7,270
1,763
Where does the training and learning come from, for example to write and publish something small, like a educational document (meant as instruction, maybe), or recipes (food prep. at home) which could be from about 10 to 30 pages? Does this come from Library Science, Journalism, Langauge & Literature graduates? The broad goal would not really be to sell much or make money, but just to write and publish useful material.

These questions come from thinking through the forum discussion, https://www.physicsforums.com/threads/science-journal-style.1014089/ .
 
Physics news on Phys.org
  • #2
symbolipoint said:
Where does the training and learning come from, for example to write and publish something small, like a educational document (meant as instruction, maybe), or recipes (food prep. at home) which could be from about 10 to 30 pages? Does this come from Library Science, Journalism, Langauge & Literature graduates? The broad goal would not really be to sell much or make money, but just to write and publish useful material.
At the university I attended for an engineering program, there was a requirement to take at least one semester of Technical Writing, which may be in the English department or perhaps Engineering. I believe many state universities have this requirement as part of an engineering program and maybe STEM in general, but I haven't looked at many programs recently.

Here's one example from Cornell, which offers several courses given the complexities of the Digital Age, and it is way more elaborate than when I was at university 40+ years ago.
https://www.engineering.cornell.edu.../engineering-communications-program/technical

Another example from University of Iowa
https://english.uiowa.edu/undergraduate-program/career-planning/engineering-technical-writing

Rutgers U
https://wp.rutgers.edu/academics/undergraduate/courses/151-322

U of Wisconsin
https://tc.engr.wisc.edu/

Standford
https://engineering.stanford.edu/students-academics/technical-communication-program

When I was in university (pre-Internet), the options were more limited. It appears that there are now entire programs on Technical Communication.
 
  • Like
  • Informative
Likes russ_watters, Oldman too, berkeman and 1 other person
  • #4
If you publish it yourself (e.g. on your own web site), in principle you can write and format it any way you like, subject to your own technical knowledge of publishing (e.g. how to format a web site).

If you rely on someone else to publish it for you, you need to follow their instructions / guidelines.

This relates to the technical aspects of publishing, in whatever medium; not the content-related aspects (how to write your material effectively so that others can hopefully understand it).
 
Last edited:
  • Like
Likes Jarvis323 and Vanadium 50
  • #5
I would very very enthusiastically recommend the book: _On Writing Well, 30th Anniversary Edition: The Classic Guide to Writing Nonfiction_ by William Zinsser.

https://www.abebooks.com/servlet/BookDetailsPL?bi=31151879470&searchurl=ds=20&kn=on+writing+well+william+zinsser+30th+anniversary+edition&sortby=17&cm_sp=snippet-_-srp1-_-title1I read this first in high school (back in the Bronze Age) and several times (in updated editions) subsequently. It is not only brilliant and instructive, but it is a very enjoyable read, as befits a book on good writing. Zinssner is not only directly instructive but also cites and excerpts many examples of good writing with very descriptive critiques. The last time I read _On Writing Well..._ I made a bibliography of all his citations and went and read all of the books noted. Particular favorite authors in this list included Joan Didion and E.B. White.

It is not a long or heavy book, and I would personally recommend approaching it in the following way (as I did most recently):

Read it three times.

First time: just blow through it. It is a fun and enjoyable book and a joy to read. Pay attention to what it says, but don't get stalled or bogged down. Enjoy it. You will be through it before you know it, and will be left wanting a sequel.

Second time: Have a clean notebook and a pen on hand and take careful notes. They will most likely suggest themselves.

Third time: Read it through again and enjoy it, but this time write the names of all the cited authors and books that he excerpts and uses as examples. You now have a reading list of excellently crafted writing, almost all of which are very enjoyable to read and make excellent examples of quality writing.

Zinsser is a proponent of clear, concise and lucid expository prose. This is something I find woefully lacking in technical, business and academic writing. His guidance will make you a better writer, and you will be vitally aware of how and why.

--diogenesNY
 
Last edited:
  • Like
  • Informative
Likes TeethWhitener, Jarvis323, berkeman and 1 other person
  • #6
diogenesNY said:
and E.B. White.
And of course Elements of Style by Strunk and White needs to be on your desk. I stand in awe of E B White for clarity of prose.
 
  • Like
Likes Jarvis323
  • #7
diogenesNY said:
I would very very enthusiastically recommend the book: _On Writing Well, 30th Anniversary Edition: The Classic Guide to Writing Nonfiction_ by William Zinsser.
Thanks for suggesting this book! I've ordered it and currently it is on its way to me from the UK.
 
  • #8
symbolipoint said:
Where does the training and learning come from, for example to write and publish something small, like a educational document (meant as instruction, maybe), or recipes (food prep. at home) which could be from about 10 to 30 pages?
Unlike some of the others who have posted in this thread, a Technical Writing course was not part of my course studies. Nevertheless, after teaching in a community college for 18 years, I changed directions and started a new career as a Programming Writer (a kind of technical writer, but where the documentation I wrote was aimed at developers rather than end users). I did this work for 15 years. Much of how I learned my craft came from reading what others had written and determining what I liked or disliked about their styles. I've also been an avid reader all of my life, so that was helpful as well.

BTW, it is seldom that a food recipe is "10 to 30 pages" long.
symbolipoint said:
Does this come from Library Science, Journalism, Langauge & Literature graduates? The broad goal would not really be to sell much or make money, but just to write and publish useful material.
No on Library Science, and probably no on Langauge & Literature, IMO, although one should have a basic understanding of how to put together grammatical sentences. A background in journalism might be somewhat helpful in how to structure your writing, but a significant part of what you write comes from expert knowledge about your chosen subject, even more so if your intent is to publish useful material.
 
  • Like
Likes berkeman
  • #10
diogenesNY said:
I would very very enthusiastically recommend the book: _On Writing Well, 30th Anniversary Edition: The Classic Guide to Writing Nonfiction_ by William Zinsser.

https://www.abebooks.com/servlet/BookDetailsPL?bi=31151879470&searchurl=ds=20&kn=on+writing+well+william+zinsser+30th+anniversary+edition&sortby=17&cm_sp=snippet-_-srp1-_-title1I read this first in high school (back in the Bronze Age) and several times (in updated editions) subsequently. It is not only brilliant and instructive, but it is a very enjoyable read, as befits a book on good writing. Zinssner is not only directly instructive but also cites and excerpts many examples of good writing with very descriptive critiques. The last time I read _On Writing Well..._ I made a bibliography of all his citations and went and read all of the books noted. Particular favorite authors in this list included Joan Didion and E.B. White.

It is not a long or heavy book, and I would personally recommend approaching it in the following way (as I did most recently):

Read it three times.

First time: just blow through it. It is a fun and enjoyable book and a joy to read. Pay attention to what it says, but don't get stalled or bogged down. Enjoy it. You will be through it before you know it, and will be left wanting a sequel.

Second time: Have a clean notebook and a pen on hand and take careful notes. They will most likely suggest themselves.

Third time: Read it through again and enjoy it, but this time write the names of all the cited authors and books that he excerpts and uses as examples. You now have a reading list of excellently crafted writing, almost all of which are very enjoyable to read and make excellent examples of quality writing.

Zinsser is a proponent of clear, concise and lucid expository prose. This is something I find woefully lacking in technical, business and academic writing. His guidance will make you a better writer, and you will be vitally aware of how and why.

--diogenesNY
Second. It’s a classic.
 
  • Like
Likes diogenesNY and berkeman
  • #11
The course I took was called Technical Writing, and the textbook was called "A Strategic Guide To Technical Communication".

https://books.google.com/books?id=uB-QtADevzMC&printsec=frontcover#v=onepage&q&f=false

The course was a writing course offered in the English department, but was less about the writing in the sense that other English courses are, and more about the effective communication part. The instructor had been a technical writer at CERN.
 
  • Like
Likes berkeman
  • #12
I have done a lot of writing but not taken a course in writing.
Spell checkers are a great thing for me. That's the main reason a got a computer to write my thesis on.

Writing different kinds of things (of course) are done in particular styles.
One I found interesting was writing SOPs, which I had to do when running a fish facility.
There are several styles of this, but I finally found a book that I really liked.
They were short with pictures. The book was produced by people who figured out simple direct ways to give complex instructions. Their model was to have step by step instructions with numbers or letters pointing to parts in a line drawing, to identify particular parts Their example was teaching people with a high school education to reliably service things like helicopters.

I would provide a reference, but I am on the opposite side of the country from the book right now.
 
  • #13
StevieTNZ said:
Thanks for suggesting this book! I've ordered it and currently it is on its way to me from the UK.
You will enjoy it! I await your review.

--diogenesNY
 
  • #14
diogenesNY said:
I would very very enthusiastically recommend the book: _On Writing Well, 30th Anniversary Edition: The Classic Guide to Writing Nonfiction_ by William Zinsser.

https://www.abebooks.com/servlet/BookDetailsPL?bi=31151879470&searchurl=ds=20&kn=on+writing+well+william+zinsser+30th+anniversary+edition&sortby=17&cm_sp=snippet-_-srp1-_-title1I read this first in high school (back in the Bronze Age) and several times (in updated editions) subsequently. It is not only brilliant and instructive, but it is a very enjoyable read, as befits a book on good writing. Zinssner is not only directly instructive but also cites and excerpts many examples of good writing with very descriptive critiques. The last time I read _On Writing Well..._ I made a bibliography of all his citations and went and read all of the books noted. Particular favorite authors in this list included Joan Didion and E.B. White.
berkeman said:
Ordered from Amazon. Thanks! :smile:
StevieTNZ said:
Thanks for suggesting this book! I've ordered it and currently it is on its way to me from the UK.
diogenesNY said:
You will enjoy it! I await your review.

--diogenesNY

I guess I'm getting impatient in my old age. "Too many notes" is my review. I've only read the first couple of chapters, but there are way too many words IMO to explain the concepts he wants to convey. In fact, there are so many extra sentences and words that I honestly have little idea what he is trying to say. Sigh.

Is there a Cliff Notes version of this book? I have the feeling that there are some jems in there, but I work 6-7 days a week, and don't have time to read through the verbose stuff.
 
Last edited:
  • #15
Maybe you would prefer The Elements of Style, by Strunk-White. It is 100 pages as opposed to this one at 300 pages.
 
  • Informative
Likes berkeman

1. How do I choose a topic to write about?

Choosing a topic to write about can be challenging, but it's important to pick something that interests you and that you have some knowledge or expertise in. Think about your passions, hobbies, or areas of study that you could write about. You can also do some research to see what topics are currently popular or relevant.

2. What is the best way to structure a short piece of writing?

When writing something small, it's important to have a clear and concise structure. Start with an introduction that grabs the reader's attention and introduces your topic. Then, have a few paragraphs that expand on your main points and provide evidence or examples. Finally, end with a conclusion that summarizes your main points and leaves a lasting impression on the reader.

3. How should I format my writing for publishing?

The formatting of your writing will depend on where you plan to publish it. If you're submitting it to a specific publication, make sure to follow their guidelines for formatting. Generally, it's best to use a standard font like Times New Roman or Arial, and to double-space your writing. It's also important to proofread for any spelling or grammar errors before submitting.

4. How can I make my writing stand out to readers?

To make your writing stand out, you can use descriptive language, incorporate personal anecdotes or experiences, and include relevant statistics or facts. It's also important to have a unique perspective or take on the topic you're writing about. Additionally, having a strong and engaging writing style can help capture the reader's attention.

5. What are some tips for getting published?

Getting published can be a competitive process, but there are a few tips that can increase your chances. First, make sure to carefully follow submission guidelines and tailor your writing to the specific publication. It's also helpful to network and make connections in the writing and publishing industry. Lastly, don't get discouraged by rejection and keep submitting your work to different publications.

Similar threads

Replies
4
Views
1K
  • General Discussion
Replies
14
Views
2K
  • STEM Educators and Teaching
Replies
9
Views
1K
  • STEM Academic Advising
Replies
6
Views
1K
  • STEM Educators and Teaching
Replies
7
Views
1K
Replies
1
Views
698
  • STEM Academic Advising
Replies
27
Views
2K
  • Art, Music, History, and Linguistics
Replies
1
Views
1K
Replies
17
Views
3K
Replies
10
Views
2K
Back
Top