Help:Writing a technical article

Starting point

edit

See Help:Contents To start with, you can experiment with wikicode in the Wikiversity:Sandbox

See Help:Wikitext quick reference

When you are ready to start writing a new article, you might want to start in your userspace:

 [[User:Your Username/Article Name]]  or  [[User:Your Username/Sandbox]] 

and move it later.

See Also

edit

Research Process

edit

See also

edit

Bibliography and Research Methods

Sources

edit

Sources can be books, magazine articles, notable websites. (See below for instructions on citing sources used.) See below for resources on wikiversity.

Learning Resources

edit

You can find some resources on Wikiversity itself; you should try to avoid replicating information already written about.

Finding Wikiversity Learning resources

edit

Portals. Every Wikiversity learning resource should be linked to by at least one portal page. You can browse the Wikiversity portals:


Categories. Every Wikiversity learning resource should be in at least one Category. You can browse Wikiversity by category. See: Category:Categories.

Search. Try using the search feature to find learning resources. See: Wikiversity:Searching.


See also

edit

English language resources

edit

General Writing tips

edit

Passive and Active Voice

edit

Common Grammar Mistakes

edit
  • It's vs. "Its "It's" is always a contraction of "it is"; "its" is possessive and means "belonging to it". Since the word it is a pronoun, it's not surprising that you might have assumed it's implied ownership. It's, however, is a contraction that means it is or it has. Its is a possessive pronoun. So, you might lament the fact that it's been forever since your last vacation but celebrate your company changing its stringent vacation policy.
  • Anyway or anyways Only the first is correct
  • Me or I When you're not sure whether you should use I or me in a sentence, try using both in a sentence "The dog followed Benjamin and me home from the store." (The dog followed Benjamin; The dog followed me)
  • Inside or outside the quotation marks periods and commas always belong inside quotation marks.
  • Loose vs Lose Don't lose your loose change
  • There, Their and They're There was a time when the lowly rat was envious of their shimmering coats of fur but, now, they're all greasy and bald too.
  • Literally Literally should only be used to refer to things that actually happened, not to add emphasis to a statement.
  • Who and Whom
  • Which and That
  • Lay and Lie
  • May and Might
  • Fewer and Less Less refers to hypothetical quantities, Few and Fewer refer to quantifiable numbers
  • Since and Because "Since" refers to time. "Because" refers to causation.
  • Affect and Effect "Affect" means to influence or produce an impression. "Effect" is the thing produced by the affecting agent; it describes the result or outcome. Effect and affect also have other uses, for example "effect" may be used as a transitive verb and mean "to bring about or make happen", such as in "My new computer effected a transition from newspaper to online articles." "Affect" can also be used as a noun to mean a display of mood or emotion, such as in "His lack of affect made him seem like a shallow person." Find more information at wikt:affect and wikt:effect.
  • Irony and Coincidence Irony is the significant difference between an expected result and an actual result. Coincidence is a series of events seem to have a meaningful connection even though they are unrelated. More information can be found at wikt:irony and wikt:coincidence.[1]

Punctuation

edit
  • Semicolons (;)

Document Design

edit

Styles

edit

Citing Sources

edit

Usage


Page text.<ref name="test">
[http://www.example.org Link text], 
additional text.</ref>

Example

edit
<ref name="litreactor">[http://litreactor.com/columns/20-common-grammar-mistakes-that-almost-everyone-gets-wrong], Litreactor</ref>

Cite Web

edit

Usage

Delete unused paramaters to help prevent clutter

All parameters, horizontal format
{{cite web |url= |title= |accessdate= |accessmonthday= |accessdaymonth = |accessyear= |author= |last= |first= |authorlink= |coauthors= |date= |date= |format= |work= |publisher= |pages= |language= |archiveurl= |archivedate= |quote= }}
All parameters, vertical format
{{cite web
| url = 
| title = 
| accessdate = 
| accessdaymonth = 
| accessmonthday = 
| accessyear = 
| author = 
| last = 
| first = 
| authorlink = 
| coauthors = 
| date = 
|date= 
| format = 
| work = 
| publisher = 
| pages = 
| language = 
| archiveurl = 
| archivedate = 
| quote = 
}}

Required parameters

edit
  • url: URL of online item.
  • title: Title of online item.

Optional parameters

edit
  • author: Author
    • last works with first to produce last, first
    • authorlink works either with author or with last & first to link to the appropriate wikipedia article. Does not work with URLs.
    • coauthors: allows additional authors
  • date: Full date of publication, preferably in ISO 8601 YYYY-MM-DD format, e.g. 2006-02-17.
    • OR: year: Year of publication, and month: Name of the month of publication. If you also have the day, use date instead.
  • format: Format, e.g. PDF. HTML implied if not specified.
  • work: If this item is part of a larger work, name of that work.
  • publisher: Publisher, if any.
  • pages: pp. 5–7: first page and optional last page. This is for listing the pages relevant to the citation, not the total number of pages in the book. This is especially useful for PDF format, where the page can be linked to with the #page=number anchor tagged on the end of the URL:
    pages = [http://www.example.org/file.pdf#page=123 p. 123]
  • language: language of publication (don't specify "English" as this is the default).
  • archiveurl: URL of the archive location of the item (requires archivedate)
  • archivedate: Date when the item was archived (requires archiveurl), in YYYY-MM-DD format, e.g. 2006-02-17. Must not be wikilinked; it will be linked automatically.
  • quote: Relevant quote from online item.

Example

edit
<ref name="litreactor">
{{cite web
| author = GINGERICH, JON
| authorlink = http://litreactor.com/team/jon-gingerich
| title = 20 Common Grammar Mistakes That (Almost) Everyone Makes
| date = 2012-01-31
| work = Lit Reactor
| url = http://litreactor.com/columns/20-common-grammar-mistakes-that-almost-everyone-gets-wrong/
| accessdate = 28 March 2014
}}
</ref>

Cite Template

edit

See Template:Cite journal

See also

edit

See Also

edit
edit

References

edit
  1. GINGERICH,JON (2012-01-31). "20 Common Grammar Mistakes That (Almost) Everyone Makes". Lit Reactor. Retrieved 28 March 2014.