: Is the Microsoft Manual of Style appropriate for writing general IT related instructional documents? I'm currently working for a company's IT department, and one of my tasks is to write documentation

I'm currently working for a company's IT department, and one of my tasks is to write documentation for common procedures that we perform, in order to get new employees acquainted with them more quickly. I was considering using the Microsoft Manual of Style as a style guide for consistency, since I find that most Microsoft support articles are easy to read and informative, but still brief.

From the reviews I've read, it seems that the book's primary audience is people designing Windows software and writing documentation for it. The files I'm writing deal with processes such as creating new users and setting up new computers. I'm not even sure if this could be considered technical writing in the first place. I'm mostly looking for information about very specific formatting, such as image placement, font usage, and line spacing, but I also would like to read about more general topics such as word choices and overall layout.

Is this book a good choice for me? If not, are there any that would be better-suited to what I'm doing?

Load Full (1)

: Including a deceased person in a dedication What is the convention when you want to dedicate a work to someone who is dead? It is necessary to be explicit about that? For example, I am

@Angela458

Load Full 1 Comments

: Citation anniversary editions How do I do MLA citations for an anniversary edition, e.g. 30th anniversary Selfish Gene. Do I treat it as a normal edition or just ignore that it is a new edition?

@Angela458

Load Full 2 Comments

: Comparison for something that's 251 million tons I'm sorry this isn't directly about writing but I don't know where I'd for this kind of question. I'm writing a paper and I'm trying to come

@Angela458

Load Full 2 Comments

: Urban Writing Question I want to write an urban book that isn't ghetto, how would you suggest I go about this? It's a love story about two young females from a urban inner-city neighborhood.

@Angela458

Load Full 1 Comments

Login to post a comment!

1 Comments

Sorted by latest first Latest Oldest Best

@Murray165

I am not specifically familiar with that book, but as much as I hate to admit it (I am not fond of microsoft) they tend to do these things well. The two pieces advice I would give you are to supplement with a traditional style guide like Chicago, and document where you draw each standard from; and to feel free to set your own style for things where the style guides are incomplete or do not fit (again documenting your standard). I would also draw from any corporate style guides or document standards as much as possible.

Load Full (0)

Feed

: Is the Microsoft Manual of Style appropriate for writing general IT related instructional documents? I'm currently working for a company's IT department, and one of my tasks is to write documentation

More posts by @Angela458

: Including a deceased person in a dedication What is the convention when you want to dedicate a work to someone who is dead? It is necessary to be explicit about that? For example, I am

: Citation anniversary editions How do I do MLA citations for an anniversary edition, e.g. 30th anniversary Selfish Gene. Do I treat it as a normal edition or just ignore that it is a new edition?

: Comparison for something that's 251 million tons I'm sorry this isn't directly about writing but I don't know where I'd for this kind of question. I'm writing a paper and I'm trying to come

: Urban Writing Question I want to write an urban book that isn't ghetto, how would you suggest I go about this? It's a love story about two young females from a urban inner-city neighborhood.

Login to post a comment!

1 Comments

Back to top