Help:Writing a technical article

From Wikiversity
Jump to navigation Jump to search

Starting point[edit | edit source]

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 | edit source]

Research Process[edit | edit source]

See also[edit | edit source]

Bibliography and Research Methods

Sources[edit | edit source]

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 | edit source]

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

Finding Wikiversity Learning resources[edit | edit source]

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 | edit source]

English language resources[edit | edit source]

General Writing tips[edit | edit source]

Passive and Active Voice[edit | edit source]

Common Grammar Mistakes[edit | edit source]

  • 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 | edit source]

  • Semicolons (;)

Document Design[edit | edit source]

Styles[edit | edit source]

Citing Sources[edit | edit source]

Usage


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

Example[edit | edit source]

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

Cite Web[edit | edit source]

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 | edit source]

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

Optional parameters[edit | edit source]

  • 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 | edit source]

<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 | edit source]

See Template:Cite journal

See also[edit | edit source]

See Also[edit | edit source]

External Links[edit | edit source]

References[edit | edit source]

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