DJB Guide: Report Writing: Difference between revisions

From Wikipedia of the Dark Brotherhood, an online Star Wars Club
m (→‎Writing the Report: Removed dead link)
 
(6 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{eras|real}}
===Introduction===
{{DJBguidenav}}


=== Reports & News Posts ===
The following documentation will cover the individual fields behind writing a basic report for the [[Dark Brotherhood|Dark Jedi Brotherhood]].  
 
The following documentation will cover the technical process behind writing a basic report for the [[Dark Brotherhood|Dark Jedi Brotherhood]]. It will outline the standard operating procedures and best practice from the top level leadership. This article aims to show you the basic do’s and don'ts of report writing, and is by no means an all encompassing be-all end-all for the way leaders in the Brotherhood go about creating reports. Everyone is encouraged to bring their own unique style and voice to their reports, and as long as the rules and guidelines are observed, it is very rare that an administrator would ask for something to be changed or in the most extreme of cases deleted from the website.  


While reports are expected from higher tier positions, they are not required at every level. Each Independent Unit tends to approach reports differently, with some units treating their respective positions differently. As a general rule of thumb and good habit, it is always best to check with your [[Clan]] or [[House]] [[Clan Summit|Summit]] with questions about creating and posting reports.
While reports are expected from higher tier positions, they are not required at every level. Each Independent Unit tends to approach reports differently, with some units treating their respective positions differently. As a general rule of thumb and good habit, it is always best to check with your [[Clan]] or [[House]] [[Clan Summit|Summit]] with questions about creating and posting reports.


[[File:Reportwriting1.png|500px|thumb|center|Report graphic for the Grand Master.]]
________________________________________________________________________________________________________________________________________________


==== Reports ====
===Report Types===


A report is an informative piece of published documentation by a leader in the Brotherhood that aims to announce, share, and/or explain information relative to their respective position or society. Reports can be broken up into the following types:
A report is an informative piece of published documentation by a leader in the Brotherhood that aims to announce, share, and/or explain information relative to their respective position or society. Reports can be broken up into the following types:


'''Dark Council''' - Reports put out by the members of the [[Dark Council]]. These reports tend to focus on each Councilor’s area of expertise and the section of the club that they oversee.  
'''Dark Council''' - Reports put out by the members of the [[Dark Council]]. These reports tend to focus on each Councilor’s area of expertise and the section of the club that they oversee.


'''Unit''' - Reports put out by the independent units that make up the Dark Jedi Brotherhood. This covers everything from entry level Battleteam Leader reports to top level Consul reports.  
'''Unit''' - Reports put out by the independent units that make up the Dark Jedi Brotherhood. This covers everything from entry level Battleteam Leader reports to top level Consul reports.


'''Society''' - Reports put out by society leaders that cover news and updates relative to their society (Wikipedia, [[Antei Combat Center]], etc.)
'''Society''' - Reports put out by society leaders that cover news and updates relative to their society (Wikipedia, [[Antei Combat Center]], etc.)
   
   
'''News''' is anything that gets published to the Dark Jedi Brotherhood’s website and appears on the main page: https://www.darkjedibrotherhood.com. This means that any report that gets posted through the site administration is posted live as a newspost.
Reports are released by a leader on some kind of determined schedule cycle. For example, a report can be released bi-weekly, monthly, quarterly. Consistency is king, as the general membership relies heavily on the announcements, shared details, and explanations of changes/events to not only keep up with the changes in the club, but also to know why things are changing.
Reports are released by a leader on some kind of determined schedule cycle. For example, a report can be released bi-weekly, monthly, quarterly. Consistency is king, as the general membership relies heavily on the announcements, shared details, and explanations of changes/events to not only keep up with the changes in the club, but also to know why things are changing.


==== News Posts ====
________________________________________________________________________________________________________________________________________________
A news post is anything that gets published to the Dark Jedi Brotherhood’s website and appears on the main page: https://www.darkjedibrotherhood.com. This means that any report that gets posted through the site administration is posted live as a newspost.
 
[[File:Reportwriting2.png|500px|thumb|center|What you see from a news post on the main page.]]
 
Please make sure to review the [[News Page Policies and Best Practices]] page to ensure your report is meeting the standard expectations and rules. This page also has great information that will be highlighted for reference in this article.
 
Additionally, you can view previously published reports in the [https://www.darkjedibrotherhood.com/news/archive News Archives].
 
[[File:Reportwriting3.png|500px|thumb|center|The News Archives.]]
 
=== Report Content ===
 
What do leaders put in their reports? Report content is entirely dependent on the information being presented, which ties into the expectations and responsibilities of the position. These expectations are usually outlined in the job description, with influence drawn from predecessors to the position and/or reader feedback. The following section breaks down the suggested content recommended by the Dark Council to be included in reports posted to the news page.
 
==== Outlining ====
 
A standard report should follow some kind of outline. The recommended starting point from the Dark Council is as follows:
 
# Introduction
# News and Updates
# Member Recognition
# Q&A / Feedback
# Conclusion/Summary
 
 
You are in no way restricted to this outline, but again this is recommended as a starting point from which you can build and expand your reports.
 
==== Dark Council Reports ====
 
Each Dark Councilor represents a different facet of the club. They cover topics that relate to their job, and are expected to alert members to any impactful changes that affect how their respective facet is handled.


For example:
===Report Breakdown===


* '''[[Grand Master]] Reports''' will tend to cover wider topics that affect the club on the whole. As the leader of the entire organization, Grand Master reports usually include major changes in leadership, policy, or provide roadmaps to the future of the club.
[[File:Unit-Position.PNG]]


* '''[[Fist of the Brotherhood|FIST]] Reports''' will tend to cover information, announcements, and updates on everything relating to Gaming in the club. This includes approved platforms, cluster balancing, as well as gaming competition administration.
'''Author:''' This field indicates the Author of the news/reports.


* '''[[Voice of the Brotherhood|VOICE]] Reports''' will tend to cover information, announcements, and updates on everything relating to the Fictional Society and Fiction System. This includes character sheets as well as fiction, run ons and other competition administration.
'''Unit/Position:''' This field indicates the position for which the member is posting content. If a member holds multiple roles it is important to ensure the correct Unit/Position is selected. In the example screenshot above, were I to post content for Arcona but select the role of Magistrate
the material would not properly filter to Arcona.


==== Unit Reports ====
________________________________________________________________________________________________________________________________________________


Independent Units — which refers to the Clans, Houses, and sub-teams that make up the DJB — have a set command structure. The entry level positions start at [[Battleteam Leader]], where the member is placed in charge of a small unit, all the way up to [[Consul]], responsible for leading the entire Clan.
[[File:Category.PNG]]


While each Consul sets the tone, schedule, and execution of reports, the Dark Council has a best practice outline it likes to direct members at. As with any report, a leader will bring their own unique style and flavor to their reports, and these are by no means an attempt to mandate how any leader writes their report.  
'''Category:''' This field indicates the intended content for the post and each member posting should ensure they choose the appropriate category. Mislabeling your Category could result in the poster being contacted to correct the post, or removal of the post.


The current positions within an Independent Unit that are able to publish reports are listed below. Some units chose not to employ certain positions, and not all units carry the same expectation for reports. Each position below, however, is paired with the best practice suggestions from the Dark Council.
'''Reports:''' The Report Category indicates any material for a specific group, this should be utilized for Battleteam, House, Clan, Magistrate, DC Assistant and Dark Council members will make use of this category when reporting to their members.


===== Battleteam Leader =====
'''DJB News:''' The DJB News category should be for any material related to the Dark Jedi Brotherhood that doesn’t fall under a report. This could include announcements, available positions and used by the Dark Council to announce events or retirements.


“BTL” Reports are where new leaders get their start, and where more than a few  learn to write their first news posts. The position is designed as an introduction to leadership at the Unit level and starts with responsibilities that tend to cover a small sub-unit, or team, within a Clan or House. A typical Battleteam Leader report should cover:
'''Star Wars News:''' The Star Wars News category is intended to display important information for the Club (and will be shown on the front page for all members) related to developments or new information from Star Wars, this could include announcements including upcoming films, features, books, comics, etc.


''(Suggested)''
'''Gaming News:''' The Gaming News category is for information related to changes or broadcasts related to the Brotherhoods gaming options. This could include topics such as upcoming Game nights, changes to supported titles or any other relevant information for the Club’s gamers.
* New information or announcements that pertain to the [[Battleteam]].  
* Roster moves: new members in, old members moving out?
* Where is the team fictionally? Where is the team out of character as a group?
* Rewards and Recognition: highlight accomplishments by members in competition awards, merit, awards, and other milestones or achievements.
* Battleteam Competitions.
* Clan/House level competitions.


''(Additional)''
'''Clan/House News:''' Similar to the Reports/DJB News, this category is used for announcements or information that doesn’t necessarily need a separate report. This could include open positions, retirements, announcement of title holders, or any other material that doesn’t include need an entire report.
* Fiction Updates
* AskTheBTL / Question and Answers section
* DB-wide competitions
* DB-wide news and reports.


Examples:
________________________________________________________________________________________________________________________________________________


* [https://www.darkjedibrotherhood.com/news/reports-shadow-s-bane-battleteam-leader-report-3 Shadow Banes Battleteam Report 3] (BTL Report, [[Clan Naga Sadow|Naga Sadow]])
[[File:Target.PNG]]
* [https://www.darkjedibrotherhood.com/news/reports-tacitus-athanasius-report-13 Tactius Athanasius Report #13] (BTL Report, [[Clan Scholae Palatinae|Scholae Palatinae]])
* [https://www.darkjedibrotherhood.com/news/reports-shadow-gate-february-report Shadow Gate February] Report (BTL Report, [[Clan Arcona|Arcona]])


===== Rollmaster =====
'''Target:''' Every News/Report should be categorized by whether members need to be logged in or if the material should be available for everyone. This is dependant of whether material within your news/reports is relevant to individuals who are not members of the Club.


“RM” reports tend to have a singular focus on presenting information and updates relevant to their position. While each Independent Unit will articulate the role and purpose of the [[Rollmaster|RM]] differently, this role has traditionally been tasked with the oversight of new members joining the Independent Unit and settling into the Brotherhood. They will often guide new members and establish relationships between veterans and newer members to assist in the process of integration into the club.
________________________________________________________________________________________________________________________________________________


This means that typically, a Rollmaster report will talk about:
[[File:Content.PNG]]


''(Suggested)''
'''Title:''' This will indicate the title displayed on the main page once the News/Report is posted. Remember to use valid titles. Report titled do not need to include what position or unit they are for as that is displayed on the main page by default.
* New member joins and introductions.  
* [[Journeymen|Journeyman]] activity, advancements, and accomplishments.
* Roster movement: Members that have come and gone.


''(Additional)''
________________________________________________________________________________________________________________________________________________
* Clan Updates and reports.
* House Updates and reports.


Examples:
[[File:Image.PNG]]


* [https://www.darkjedibrotherhood.com/news/reports-arcona-rollmaster-round-up-eighth-report-for-the-ninth-month Arcona Rollmaster Roundup: Eight Report] (RM Report, Arcona)
'''Image:''' The Image field indicates the image that will displayed on the main page, in the example provided. The two options are the generic Dark Brotherhood image which should be generally used for any Club-wide News posts. Alternative options include Clan images, which should be used for Clan and House reports or news, or Role specific images such as the Dark Council.
* [https://www.darkjedibrotherhood.com/news/reports-cou-rollmistress-report-3-for-the-glory-of-odan-urr-and-shinies COU Rollmistress Report #3] (RM Report, [[Clan Odan-Urr|Odan-Urr]])


===== Aedile and Quaestor =====
'''Content:''' The body of the Report/News post this is where you will post the content of your report/news post. It is suggested to split the main body content into sections with the use of Markdown. For more info look at


“AED” and “QUA” Reports often vary depending on the unit or leadership team dynamic. Sometimes [[Aedile|Aediles]] and [[Quaestor|Quaestors]] will do joint House-level Reports, and sometimes they can alternate writing one or the other. House-level reports tend to address multiple subunits, or at least are targeted at a wider  audience than just a single Battleteam. This means that the level of detail and quality carries increased expectations. These expectations are different between each Unit’s command structure.  As such, the following best practices are flexible between both positions. A House-level report usually covers:
* [[https://www.darkjedibrotherhood.com/shadow_academy/courses/86| Markdown 101]]  
* [[https://www.darkjedibrotherhood.com/shadow_academy/courses/100-markdown-102| Markdown 102]].


''(Suggested)''
'''Abstract/Subheading:''' As noted in the post options, “Please provide a short summary or sub-heading for your report or news post” This Abstract is what will appear alongside the image of the News/Report on the front page. This should relate to the material within or be a small snippet of the content within. Snapshots do not use Markdown.
* New information or announcements that pertain to the House.
* Roster moves: new members in, old members moving out?
* Where is the House fictionally? Where is the team out of character as a group?
* Plans for the future? Upcoming events?
* Rewards and Recognition: highlight accomplishments by members of the House in competition earnings, merit awards, exams passed, and other milestones or achievements.
* BTL/House/Clan level news.
* BTL/House/Clan level competitions.
* DB-wide news and reports.
* DB-wide competitions.


''(Optional)''
________________________________________________________________________________________________________________________________________________
* House Fiction updates.
* AskTheQUA or AED  / Questions and Answers section.


Examples:
[[File:Tags.PNG]]
* [https://www.darkjedibrotherhood.com/news/reports-february-qel-droma-report February Qel-Droma Report] (House Report, Arcona)
* [https://www.darkjedibrotherhood.com/news/reports-house-excidium-report-5-a-solid-foundation House Excidium Report #5: A Solid Foundation] (House Report, Scholae Palatinae)
* [https://www.darkjedibrotherhood.com/news/reports-hap-quaestor-report-february-2017 HAP Quaestor Report - February 2017] (QUA Report, [[Clan Plagueis|Plagueis]])
* [https://www.darkjedibrotherhood.com/news/reports-october-qua-report October QUA Report] (QUA Report, Odan Urr)


===== Proconsul and Consul =====
'''Tags:''' Tags are important to ensure that the News/Report appears for the accurate members and should include any material such as: Clan, Star Wars, Retirement, Promotion, etc.


“PCON” and “CON” Reports often vary depending on the unit or leadership team dynamic. Sometimes [[Proconsul]] and Consul will do joint Clan-level Reports, and sometimes they can alternate writing one or the other. Clan-level reports focus on issues that affect the entire unit, as well as provide introspection and awareness of what goes on outside the Clan across the Brotherhood and with other units. Members usually look to Clan-level reports to gain information on how the larger DB applies to them. As such, the following best practices are flexible between both positions. A Clan-level report usually covers:
'''Comment Method:'''


* New information or announcements that pertain to the entire Clan.  
* Local: Comments are posted locally on the website and are visible to everyone viewing them. Only registered members may comment locally. These are used for simple comments and are not suited for extended discussions.
* Roster moves: new members in, old members moving out?
* Discourse: Comments are diverted to our [[https://discourse.darkjedibrotherhood.com/c/news-and-reports|Discourse board]] where members may engage more openly in discussions regarding the content of the News or Report. Discourse rules apply.
* Where is the Clan fictionally? Where is the team out of character as a group?
* Disabled: No comments are allowed. Used sparingly and is generally discouraged unless there is a valid reason to do so.
* Plans for the future? Upcoming events?
* Rewards and Recognition: highlight accomplishments by members of the Clan in competition earnings, merit awards, exams passed, and other milestones or achievements.  
* BTL/House/Clan level news and reports.
* BTL/House/Clan level competitions.
* Inter-Unit news, job openings, competitions, and events.
* DB-wide news and reports.
* DB-wide competitions.


''(Optional)''
________________________________________________________________________________________________________________________________________________
* Clan Fiction updates.
* AskTheCON or PCON  / Questions and Answers section.


Examples:
[[File:Preview.PNG]]


* [https://www.darkjedibrotherhood.com/news/reports-arcona-consul-report-15-the-special-hell Arcona Consul Report #15: The Special Hell] (Consul Report, Clan Arcona)
'''Preview News Content:''' This option allows you to preview the Content section of your post, this should be used with every post to ensure that your Markdown is accurate, review the material for any adjustments or errors that need to be corrected. Once you have made adjustments, use the preview option again until the post is ready to submit.


==== Society Reports ====
'''Preview News Item:''' This will allow you to preview how the post will appear on the Dark Jedi Brotherhoods homepage. This includes what image you have selected, the role you have selected as well as the Abstract/Summary section in how it will appear for members. Again as mentioned above, use this option and ensure all of your content is ready for submission.


Currently, the two society reports that are active in the Dark Jedi Brotherhood are: [[Combat Master]] (ACC administration) and [[Wiki Tribune]] (Wikipedia administration). As these positions are held by members that have demonstrated a masterful understanding and command over their society, they each handle reports in their own manners.
'''Submit News:''' Prior to selecting this option, ensure your content is accurate, has been proofed, you have used the preview options below and are ready to post the content prior to Submitting.  


Examples:
________________________________________________________________________________________________________________________________________________


* [https://www.darkjedibrotherhood.com/news/reports-combat-master-6-help-me-help-you Combat Master #6: Help Me... Help You...] (Combat Master Report by [[Atra Ventus]])
* [https://www.darkjedibrotherhood.com/news/reports-wiki-tribune-report-7-new-year-new-canon Wiki Tribune Report #7: New Year, New Canon] (Wiki Tribune Report by [[Selika Roh]])
=== Writing the Report ===
=== Writing the Report ===


When writing a report, there are a few different tools you can use. The most popular and common one — that is available to all members and completely free — is [http://drive.google.com/ Google Docs]. Google Docs allow you to easily share your reports with your supervisors or friends to get approval, feedback, or proofreading before posting. Alternatively, you can write your report in your word processor of choice with things like Microsoft Word, Apple Pages, or even a simple Word Pad.  
When writing a report, there are a few different tools you can use. The most popular and common one — that is available to all members and completely free — is [http://drive.google.com/ Google Docs]. Google Docs allow you to easily share your reports with your supervisors or friends to get approval, feedback, or proofreading before posting. Alternatively, you can write your report in your word processor of choice with things like Microsoft Word, Apple Pages, or even a simple Word Pad.


Since the Dark Jedi Brotherhood website leverages Markdown coding for reports and news posts, you can alternatively — or additionally — take advantage of Markdown Preview editors. This allows you to type on one side of the screen and play with code while generating a preview of how it will look when posted. The Dark Council recommends:
Since the Dark Jedi Brotherhood website leverages Markdown coding for reports and news posts, you can alternatively — or additionally — take advantage of Markdown Preview editors. This allows you to type on one side of the screen and play with code while generating a preview of how it will look when posted. The Dark Council recommends:


* [http://dillinger.io/ Dillinger] - One of the best preview tools available. Great save features, streamlined and easy to use.  
* [http://dillinger.io/ Dillinger] - One of the best preview tools available. Great save features, streamlined and easy to use.
* [https://stackedit.io/editor Stack Edit] - Full featured preview tool with example template.
* [https://stackedit.io Stack Edit] - Full featured preview tool with example template.
* [http://socrates.io/ Socrates] - Super minimalist design. Easy to share with others.
 
Note: It is always wise to have your reports proofread by at least one other person. This can be a friend you trust, or your supervisor, but proofreading is strongly recommended.


'''Note''': It is always wise to have your reports proofread by at least one other person. This can be a friend you trust, or your supervisor, but proofreading is '''strongly''' recommended.
=== Formatting ===


==== Formatting ====
Formatting is the key to making your reports not only aesthetically appealing to a reader. It also makes them clear and easy to read. The more clear and concise your report is formatted, the better chance of not losing or confusing the members you want reading the report you worked so hard on!


Formatting is the key to making your reports not only aesthetically appealing to a reader. It also makes them clear and easy to read. The more clear and concise your report is formatted, the better chance of not losing or confusing the members you want reading the report you worked so hard on!
As stated above, the website takes advantage of Markdown coding, which you can learn all about in the following Shadow Academy Exams:
[https://www.darkjedibrotherhood.com/shadow_academy/courses/86 Markdown 101] and
[https://www.darkjedibrotherhood.com/shadow_academy/courses/100 Markdown 102].


As stated above, the website takes advantage of Markdown coding, which you can learn all about in the following Shadow Academy Exams: [https://www.darkjedibrotherhood.com/shadow_academy/courses/86 Markdown 101] and [https://www.darkjedibrotherhood.com/shadow_academy/courses/100 Markdown 102]. It is highly recommended  to complete these courses prior to writing a report. These courses are quick, informative, and educational. They will help create a foundation for your ability to write clear and easy to read reports.  
It is highly recommended  to complete these courses prior to writing a report. These courses are quick, informative, and educational. They will help create a foundation for your ability to write clear and easy to read reports.


For the purpose of focusing on the presentation of a report, this article will highlight the fundamental elements of Markdown that come in handy when writing a report.  
For the purpose of focusing on the presentation of a report, this article will highlight the fundamental elements of Markdown that come in handy when writing a report.


===== Headers =====
==== Headers ====


Headers are important because they help break up information and create definitive starts and stops to topics throughout the report. Reports are read from top to bottom, so anytime you’re going to change subjects it is good to insert a header. The best practice with headers is to use a descending flow of sub-topics. The top heading should be the "parent" topic, something like '''Recognition'''. A sub-topic for that would be '''Promotions''', since Promotions are a kind of recognition, similar to '''Awards'''.
Headers are important because they help break up information and create definitive starts and stops to topics throughout the report. Reports are read from top to bottom, so anytime you’re going to change subjects it is good to insert a header. The best practice with headers is to use a descending flow of sub-topics. The top heading should be the "parent" topic, something like '''Recognition'''. A sub-topic for that would be '''Promotions''', since Promotions are a kind of recognition, similar to '''Awards'''.
Line 198: Line 129:
<pre>
<pre>
## Recognition
## Recognition
### Promotions!
### Promotions!
### Awards!
### Awards!
</pre>
</pre>
Line 208: Line 137:
<pre>
<pre>
Text.
Text.
---
---
More text.
More text.
</pre>
</pre>


===== Bullet Points, Numbered Lists =====
==== Bullet Points, Numbered Lists ====
 
A good way to break up talking points or to make a list of information easier to read is by using bullet points or numbered lists.


* You can use bullet points by using an asterisk (*) or a dash (-) followed by a space.  
A good way to break up talking points or to make a list of information easier to read is by using bullet points or numbered lists.


* You can use bullet points by using an asterisk (*) or a dash (-) followed by a space.
* You can create a numeric list by using a number followed by a period  (1.) followed by a space.
* You can create a numeric list by using a number followed by a period  (1.) followed by a space.


<pre>
<pre>
* Topic 1
* Topic 1
* Topic 2  
* Topic 2
 
1. Topic 1
1. Topic 1
2. Topic 2  
2. Topic 2
</pre>
</pre>


Usually, lists will trigger their formatting automatically. If for some reason they do not, make sure to add a double space after each point.
Usually, lists will trigger their formatting automatically. If for some reason they do not, make sure to add a double space after each point.


===== Hyperlinks, Bold, Italics =====
==== Hyperlinks, Bold, Italics ====


Using bold and italics is a great way to help emphasize points you want to drive home in your report. To '''bold''' or ''italicize'' something in Markdown, you can use the following code:
Using bold and italics is a great way to help emphasize points you want to drive home in your report. To '''bold''' or ''italicize'' something in Markdown, you can use the following code:
Line 248: Line 173:
</pre>
</pre>


===== Inserting Images and Gifs =====
==== Inserting Images and Gifs ====


You can insert images and gifs into your reports. These are good to break up walls of text or to add levity. Just remember the old adage "all things in moderation" and try not to overuse images and graphics.
You can insert images and gifs into your reports. These are good to break up walls of text or to add levity. Just remember the old adage "all things in moderation" and try not to overuse images and graphics.
* Note: Do not use the Assets options within Administration for GIFS/Images to include in your report, host these via an alternative source (imgur, etc) and use the proper markdown to include them in your report.
* Secondary: Images will only appear if the url includes https (ex: https://wiki.darkjedibrotherhood.com would function / http://wiki.darkjdedibrotherhood.com would not).


<pre>
<pre>
Line 260: Line 188:
'''Important''': Images and gifs must include the filename in the url (.jpg, .png, .gif) in order to work. Using a .com, or any other website extension will not work.
'''Important''': Images and gifs must include the filename in the url (.jpg, .png, .gif) in order to work. Using a .com, or any other website extension will not work.


===== Centering Images =====
==== Centering Images ====
 
While everyone has their own styles, the best practice and common style for reports is to center images. You can do this using the following markdown coding.
While everyone has their own styles, the best practice and common style for reports is to center images. You can do this using the following markdown coding.


Line 268: Line 197:


-> Right-aligned Image
-> Right-aligned Image
=== Creating a Report ===
[[File:Reportwriting4.png|500px|thumb|center|Snapshot of the Administration panel.]]
To post/publish your report to the main page, head over to the '''Administration Menu''' -> Navigate to: “'''News and Reports'''” -> and then select: “'''Manage News and Reports'''”.
[[File:Reportwriting5.png|500px|thumb|center|The create post menu from the Administration page.]]
==== Naming Reports (Title) ====
As a best practice, the Dark Council recommends the following format when creating reports for the news page.
> [Unit Name] [Report] [Report #] - [Title/Subject] (Optional)
Alternatively, you can change things up according to your preference and style. You can reference the date and/or the month, lead with a catchy title, or switch around the order of the above example. Keep in mind when using months by themselves, however, that you run the potential risk of lapping yourself and running into having duplicate “May Rainbow Squadron” reports. Which is fine, if you’re into that kind of thing, of course.
The important thing is to make sure you are in some way including the name or position in your title so that anyone scrolling through a list of reports knows how to easily identify what kind of report you’ve created and posted.
==== Choosing a Category ====
For reports, you are going to always want to use the “Reports” category. This keeps reports separate from newposts that announce things such as the new Star Wars trailer that just came out or major announcement that we want outside viewers to see.
For information on the other categories, refer to the [[News Page Policies and Best Practices]] page.
In the field right below it, you select your leadership position as the “Context” that you will be posting the report under.
=== Context ===
The context field here pertains to the position you are posting from. You will be provided a drop down box that gives you a selection of multiple positions. If you’re a Battleteam Leader, you would select “Battleteam Leader” for contex. If you’re a member of the Shadow Academy Staff, you select “Shadow Academy: Professor (Assistants)".
=== Rolling News banner ===
Rolling news banners are displayed at the top of the main page for https://www.darkjedibrotherhood.com and work on a horizontal carousel.
[[File:Reportwriting6.JPG|500px|thumb|center|Example of a rolling news banner.]]
==== Body ====
This is where you copy and paste your report when you’re ready to see what it looks like and then post it. This should include the content outlined in the above section.
=== Tag List ===
Tags allow you to easily identify and sort reports when searching through the archives. It also can affect how hashtags get implemented when reports are posted to social media.
For information on Tag Lists, refer to the [[News Page Policies and Best Practices]] page.
=== Comment Method ===
There are three options for how report comments are handled. You may select comments to be local, linked on discourse, or disabled.
''Local comments'' appear under the report itself on the main page. This is the standard method for allowing commentary on reports from your peers.
[[File:Reportwriting7.png|500px|thumb|center|The local comments found under a report.]]
''Discourse comments'' link to our discourse forum. This is usually used for reports that want to take advantage of engaging with members on topics covered in the report itself.
[[File:Reportwriting8.png|500px|thumb|center|An example of the discourse report.]]
''Disabled comments'' is used for when you post a report that you do not wish anyone to leave comments. This is usually done when a decision is shared from the top executive level and isn’t open for further discussion from the membership.
[[File:Reportwriting9.png|500px|thumb|center|Disabled comments.]]
Only members of the Brotherhood are able to comment on reports. As a best practice, be polite when responding to report comments, even if members get aggressive or use language that makes you feel uncomfortable. If you feel that someone has violated the [[Covenant|Dark Covenant]] in your report comments, make sure you reach out to the [[Justicar]] and the Hands of Justice. The Brotherhood has a zero tolerance policy on harassment. 
=== Publishing ===
Once you’re done writing and formatting your report, it's time to publish it and post it to the site.
Before posting, you should '''always''' make sure to preview your report. The Preview window will show you a preview of what your report will look like once it is posted to the main page. This is a great way to check for formatting errors that either show up when copying over from a word/google document, or even minor coding blips that can occur between a markdown preview tool. In short, no matter how/where you are writing your reports, the Preview  window will give you an exact example of what your report will look like!
[[File:Reportwriting10.png|500px|thumb|center|The preview function can be found at the bottom of a written report.]]
==== Editing A News Post ====
Caught a mistake that you missed when previewing your report? Wanted to go back in and clarify something? Don’t panic. Once a report is posted to the news page, you can easily edit it from your administration menu. Any edits made will update the currently posted newspost, overwriting the previous version. You can edit a report as many times as you need, and no duplicate copies are made when updating a report in this manner.
=== Summary ===
The easiest way to tie everything together is to demonstrate how a basic report should look. To that end, we’ve created a [https://goo.gl/H19AWm Dark Jedi Brotherhood Report Template] that you can use to help write your own reports.
You can view the [https://www.darkjedibrotherhood.com/news/reports-shadow-academy-example-report-1 Example Report] here from the News Archive.


=== Conclusion ===
=== Conclusion ===


By following this guide, and the best practices outlined within it, you should feel confident in either writing your first report, or implementing a new trick you learned into your existing reports. As with most skills, report writing becomes easier the more and more you do it. Don’t be afraid to ask questions. Don’t be afraid to have your superior or a trusted friend read over your report.  
By following this guide, you should feel confident in either writing your first report, or implementing a new trick you learned into your existing reports. As with most skills, report writing becomes easier the more and more you do it. Don’t be afraid to ask questions. Don’t be afraid to have your superior or a trusted friend read over your report.


==== Useful Tools for Report Writing ====
==== Useful Tools for Report Writing ====

Latest revision as of 20:18, 27 March 2024

Introduction

The following documentation will cover the individual fields behind writing a basic report for the Dark Jedi Brotherhood.

While reports are expected from higher tier positions, they are not required at every level. Each Independent Unit tends to approach reports differently, with some units treating their respective positions differently. As a general rule of thumb and good habit, it is always best to check with your Clan or House Summit with questions about creating and posting reports.

________________________________________________________________________________________________________________________________________________

Report Types

A report is an informative piece of published documentation by a leader in the Brotherhood that aims to announce, share, and/or explain information relative to their respective position or society. Reports can be broken up into the following types:

Dark Council - Reports put out by the members of the Dark Council. These reports tend to focus on each Councilor’s area of expertise and the section of the club that they oversee.

Unit - Reports put out by the independent units that make up the Dark Jedi Brotherhood. This covers everything from entry level Battleteam Leader reports to top level Consul reports.

Society - Reports put out by society leaders that cover news and updates relative to their society (Wikipedia, Antei Combat Center, etc.)

News is anything that gets published to the Dark Jedi Brotherhood’s website and appears on the main page: https://www.darkjedibrotherhood.com. This means that any report that gets posted through the site administration is posted live as a newspost.

Reports are released by a leader on some kind of determined schedule cycle. For example, a report can be released bi-weekly, monthly, quarterly. Consistency is king, as the general membership relies heavily on the announcements, shared details, and explanations of changes/events to not only keep up with the changes in the club, but also to know why things are changing.

________________________________________________________________________________________________________________________________________________

Report Breakdown

Author: This field indicates the Author of the news/reports.

Unit/Position: This field indicates the position for which the member is posting content. If a member holds multiple roles it is important to ensure the correct Unit/Position is selected. In the example screenshot above, were I to post content for Arcona but select the role of Magistrate the material would not properly filter to Arcona.

________________________________________________________________________________________________________________________________________________

Category: This field indicates the intended content for the post and each member posting should ensure they choose the appropriate category. Mislabeling your Category could result in the poster being contacted to correct the post, or removal of the post.

Reports: The Report Category indicates any material for a specific group, this should be utilized for Battleteam, House, Clan, Magistrate, DC Assistant and Dark Council members will make use of this category when reporting to their members.

DJB News: The DJB News category should be for any material related to the Dark Jedi Brotherhood that doesn’t fall under a report. This could include announcements, available positions and used by the Dark Council to announce events or retirements.

Star Wars News: The Star Wars News category is intended to display important information for the Club (and will be shown on the front page for all members) related to developments or new information from Star Wars, this could include announcements including upcoming films, features, books, comics, etc.

Gaming News: The Gaming News category is for information related to changes or broadcasts related to the Brotherhoods gaming options. This could include topics such as upcoming Game nights, changes to supported titles or any other relevant information for the Club’s gamers.

Clan/House News: Similar to the Reports/DJB News, this category is used for announcements or information that doesn’t necessarily need a separate report. This could include open positions, retirements, announcement of title holders, or any other material that doesn’t include need an entire report.

________________________________________________________________________________________________________________________________________________

Target: Every News/Report should be categorized by whether members need to be logged in or if the material should be available for everyone. This is dependant of whether material within your news/reports is relevant to individuals who are not members of the Club.

________________________________________________________________________________________________________________________________________________

Title: This will indicate the title displayed on the main page once the News/Report is posted. Remember to use valid titles. Report titled do not need to include what position or unit they are for as that is displayed on the main page by default.

________________________________________________________________________________________________________________________________________________

Image: The Image field indicates the image that will displayed on the main page, in the example provided. The two options are the generic Dark Brotherhood image which should be generally used for any Club-wide News posts. Alternative options include Clan images, which should be used for Clan and House reports or news, or Role specific images such as the Dark Council.

Content: The body of the Report/News post this is where you will post the content of your report/news post. It is suggested to split the main body content into sections with the use of Markdown. For more info look at

Abstract/Subheading: As noted in the post options, “Please provide a short summary or sub-heading for your report or news post” This Abstract is what will appear alongside the image of the News/Report on the front page. This should relate to the material within or be a small snippet of the content within. Snapshots do not use Markdown.

________________________________________________________________________________________________________________________________________________

Tags: Tags are important to ensure that the News/Report appears for the accurate members and should include any material such as: Clan, Star Wars, Retirement, Promotion, etc.

Comment Method:

  • Local: Comments are posted locally on the website and are visible to everyone viewing them. Only registered members may comment locally. These are used for simple comments and are not suited for extended discussions.
  • Discourse: Comments are diverted to our [board] where members may engage more openly in discussions regarding the content of the News or Report. Discourse rules apply.
  • Disabled: No comments are allowed. Used sparingly and is generally discouraged unless there is a valid reason to do so.

________________________________________________________________________________________________________________________________________________

Preview News Content: This option allows you to preview the Content section of your post, this should be used with every post to ensure that your Markdown is accurate, review the material for any adjustments or errors that need to be corrected. Once you have made adjustments, use the preview option again until the post is ready to submit.

Preview News Item: This will allow you to preview how the post will appear on the Dark Jedi Brotherhoods homepage. This includes what image you have selected, the role you have selected as well as the Abstract/Summary section in how it will appear for members. Again as mentioned above, use this option and ensure all of your content is ready for submission.

Submit News: Prior to selecting this option, ensure your content is accurate, has been proofed, you have used the preview options below and are ready to post the content prior to Submitting.

________________________________________________________________________________________________________________________________________________

Writing the Report

When writing a report, there are a few different tools you can use. The most popular and common one — that is available to all members and completely free — is Google Docs. Google Docs allow you to easily share your reports with your supervisors or friends to get approval, feedback, or proofreading before posting. Alternatively, you can write your report in your word processor of choice with things like Microsoft Word, Apple Pages, or even a simple Word Pad.

Since the Dark Jedi Brotherhood website leverages Markdown coding for reports and news posts, you can alternatively — or additionally — take advantage of Markdown Preview editors. This allows you to type on one side of the screen and play with code while generating a preview of how it will look when posted. The Dark Council recommends:

  • Dillinger - One of the best preview tools available. Great save features, streamlined and easy to use.
  • Stack Edit - Full featured preview tool with example template.

Note: It is always wise to have your reports proofread by at least one other person. This can be a friend you trust, or your supervisor, but proofreading is strongly recommended.

Formatting

Formatting is the key to making your reports not only aesthetically appealing to a reader. It also makes them clear and easy to read. The more clear and concise your report is formatted, the better chance of not losing or confusing the members you want reading the report you worked so hard on!

As stated above, the website takes advantage of Markdown coding, which you can learn all about in the following Shadow Academy Exams:

Markdown 101 and Markdown 102.

It is highly recommended to complete these courses prior to writing a report. These courses are quick, informative, and educational. They will help create a foundation for your ability to write clear and easy to read reports.

For the purpose of focusing on the presentation of a report, this article will highlight the fundamental elements of Markdown that come in handy when writing a report.

Headers

Headers are important because they help break up information and create definitive starts and stops to topics throughout the report. Reports are read from top to bottom, so anytime you’re going to change subjects it is good to insert a header. The best practice with headers is to use a descending flow of sub-topics. The top heading should be the "parent" topic, something like Recognition. A sub-topic for that would be Promotions, since Promotions are a kind of recognition, similar to Awards.

Headers are handled by using a different count of pound (#) signs.

## Recognition
### Promotions!
### Awards!

You can also separate sections using the insert line function, also called a page break. You can trigger this by using 3 (or 5) consecutive dashes “---”. To make sure the formatting triggers, you need to make sure to include a line returns before and after the dashes (press enter/return above and then below).

Text.
---
More text.

Bullet Points, Numbered Lists

A good way to break up talking points or to make a list of information easier to read is by using bullet points or numbered lists.

  • You can use bullet points by using an asterisk (*) or a dash (-) followed by a space.
  • You can create a numeric list by using a number followed by a period (1.) followed by a space.
* Topic 1
* Topic 2
1. Topic 1
2. Topic 2

Usually, lists will trigger their formatting automatically. If for some reason they do not, make sure to add a double space after each point.

Hyperlinks, Bold, Italics

Using bold and italics is a great way to help emphasize points you want to drive home in your report. To bold or italicize something in Markdown, you can use the following code:

*Italics* / _Italics_
**Bold** / __Bold__
***Bold-Italics*** / ___Bold-Italics___

A hyperlink is a highlighted piece of text on a webpage that, when clicked, brings you to another web page. Hyperlinks are important because they can help easily route readers to information that might be useful. To insert hyperlinks in Markdown, you can use the following code:

[Hyperlink Text](http://webpage.com)

Inserting Images and Gifs

You can insert images and gifs into your reports. These are good to break up walls of text or to add levity. Just remember the old adage "all things in moderation" and try not to overuse images and graphics.

  • Note: Do not use the Assets options within Administration for GIFS/Images to include in your report, host these via an alternative source (imgur, etc) and use the proper markdown to include them in your report.
  • Secondary: Images will only appear if the url includes https (ex: https://wiki.darkjedibrotherhood.com would function / http://wiki.darkjdedibrotherhood.com would not).
![alt text](https:imageurl.png)

Important: Images and gifs must be “https” secure. Most popular images will use https, but if you run into issues you can use sites like imgur to host a secure image or gif.

Important: Images and gifs must include the filename in the url (.jpg, .png, .gif) in order to work. Using a .com, or any other website extension will not work.

Centering Images

While everyone has their own styles, the best practice and common style for reports is to center images. You can do this using the following markdown coding.

-> Centered Image <-

Anything else will default to Left-aligned. If you want to Right-align an image you can use the “->” arrow by itself.

-> Right-aligned Image

Conclusion

By following this guide, you should feel confident in either writing your first report, or implementing a new trick you learned into your existing reports. As with most skills, report writing becomes easier the more and more you do it. Don’t be afraid to ask questions. Don’t be afraid to have your superior or a trusted friend read over your report.

Useful Tools for Report Writing

  • Dillinger.io - Markdown preview tool.
  • Markdown 101 - SA Exam that teaches you how to use Markdown.
  • Markdown 102 - SA Exam that teaches you how to use Markdown.
  • Google Docs - Easily share writing and receive proofreading from peers.
  • Imgur - For hosting images securely with https.
  • Goo.gl - Url shortening.