Wikibooks:WikiProject OpenRewi - Open Legal Science/Styleguide

From Wikibooks, open books for an open world
Jump to navigation Jump to search

Headings and Sub-Headings[edit source]

Headings and Sub-headings within each chapter are numbered using the following format:

A.

I.

1.

a)

a))

Chapter Structure[edit source]

Each chapter is composed of:

  1. a reference to required previous knowledge (with links to other book chapters)
  2. intended learning outcomes
  3. main text
  4. summary
  5. further readings
  6. footnotes

Basic Knowledge and Advanced Knowledge[edit source]

It is essential to keep in mind our audience when writing each book chapter. The main audience are undergraduate or other students who use this textbook to familiarize themselves with a topic for the first time. The ‘basic knowledge’ category comprises anything that serves the purpose of introducing the reader to a topic. The ‘advanced knowledge’ category is reserved for content that may be interesting for graduate students or for students writing an essay or a thesis on this specific topic.

Advanced: Example

This is your advanced content. You can create this text box using our template "Advanced". How to do this is described here.


Links to other Book Chapters or other OpenRewi Materials[edit source]

Please use links to refer when mentioning a concept, rule, etc. that is relevant to your chapter but that another chapter treats more in depth.

Placing the Link in Your Chapter[edit source]

If you want the link to lead to more information on a specific concept, please place the link on the specific term describing said concept (e.g. ‘consent’).

If you want to link to lead to further information on the point you are making in a sentence or paragraph more generally, please place the link on the active verb of said sentence or of the paragraph's topic sentence.

Technical Instructions for Placing Links[edit source]

There are two possible ways of linking to another chapter on Wikibooks:

  1. You can link to another chapter using this syntax: [[Title of your book/ Chapter|Text that should appear for the link to other chapters]]. In the visual editor, you can just select the text on which you want to place the link, then click on the link symbol (or press Ctrl+K) and type in 'Title of your book/ Chapter'.
  2. You can also refer specifically to a specific section or sentence by placing an anchor in the other chapter and linking to said anchor. First, think of where you want to place the anchor (i.e. to which specific part of the other chapter you want to refer). Then, think of a concise name for your anchor, which ideally captures the topic of the sentence, paragraph, or section in one word. Proceed by placing your anchor using the following syntax: {{anchor|name of your anchor}}. In the visual editor, you can click on 'Insert', select 'Template' from the drop-down menu and type in 'Anchor' and then select the name of your anchor. Finally, you can add the link to your own chapter using the anchor with this syntax: [[Title of your book/ Chapter#anchor:name of your anchor|Text that should appear for the link to an anchor]]. Again, you can also place the link using the link symbol or Ctrl+K and the type in 'Title of your book/ Chapter#anchor:name of your anchor'.

References[edit source]

When adding references to your chapter, please keep the audience of the book (students) in mind. Provide the references that are necessary in terms of academic ethics, but please do not include references, e.g., to every other textbook explaining the same point. Whenever possible, cite work written by FLINT authors and/or authors located in the Global South.

Please adhere to OSCOLA when formating citations.

Whenever possible, provide a link with the citation, ideally to an open-access source.

Further Readings[edit source]

The indications for further readings at the end of each chapter should not be a mini-bibliography on your topic. Instead, they should contain key texts that can facilitate deeper reflection on the questions you addressed in your chapter.