Help:Writing a technical article
Starting point
editSee 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
editResearch Process
editSee also
editSources
editSources can be books, magazine articles, notable websites. (See below for instructions on citing sources used.) See below for resources on wikiversity.
Learning Resources
editYou can find some resources on Wikiversity itself; you should try to avoid replicating information already written about.
Finding Wikiversity Learning resources
editPortals. Every Wikiversity learning resource should be linked to by at least one portal page. You can browse the Wikiversity portals:
Humanities · Physical Sciences · Life Sciences · Practical Arts and Sciences · Mathematics · Computer Science · Engineering and Technology · Interdisciplinary Studies · Social Sciences · Education · Media · Professions · Learning Projects · Learning Materials · Research · Informatics · Other 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
editEnglish language resources
edit- The English Language Reference Desk is an excellent place to go to get specific help with any aspect of English (modern or ancient).
- Writing Center Portal
General Writing tips
editPassive and Active Voice
editCommon 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
editStyles
editCiting Sources
editUsage
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
editUsage
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
- last works with first to produce
- 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
editSee also
edit- w:Cite sources: Style guide
- w:Cite sources/example style: Style guide examples
- w:Citation templates: Related templates
See Also
editExternal Links
editReferences
edit- ↑ GINGERICH,JON (2012-01-31). "20 Common Grammar Mistakes That (Almost) Everyone Makes". Lit Reactor. Retrieved 28 March 2014.