DErik's TP 2

From RCGRS MRT Wiki
Jump to navigation Jump to search

Testing link preview:
https://www.rcgrs.com/mrtwiki/index.php?title=DErik%27s_TP_2
[1]
[[2]]
https://www.rcgrs.com/mrtwiki/index.php?title=RCGRS_MRT_SIG
[RCGRS MRT SIG]
MRT SIG Home
RCGRS MRT SIG

Publication Work Flow

The steps that should be taken to publish an article here should be the following. At present, we are not enforcing this either, and frankly, I'm not sure that we can. But good etiquette and practices should indicate the need for these steps.

  1. You first create a draft of the article. You can use whatever medium you desire and feel comfortable with. For example:
    • Simple paper and pencil (and maybe some crayons) would work to create the first draft.
    • Or you could use Apple's "Text Editor" or Microsoft's "Notepad" applications. These produce text (.TXT) files with no formatting capabilities. Very simple and easy to use.
    • Or step up a bit to use "Notepad++", a free download, but it only works on Windows platforms. But it understands things like programming languages (Java, C++, C#, Python, PHP, others) and markup languages (HTML, CSS, XML, even TeX which is used for math equations, but it doesn't understand Wiki markups 🥲). It will save files in with an extension compatible to the type of file it thinks it is. But they are all essentially straight text files. There is no formatting capability saved with the file.
    • To save a bit of formatting you could then step up to using:
      • Apple's Pages (creates a .PAGES file, but can be exported to PDF, Word DOCX, Rich Text Format (.RTF file), and a few others).
      • Or MS's Word (DOCX for latest version of Word, also exports as PDF, DOC, ODT, RTF, MHT, MHTML, others). The MHT and MHTML are somewhat equivalent to HTML or HTM pages, which are what are normally stored on web servers and what you see in the browsers.
      • Another option is using LibreOffice, a free download that has capabilities for formatting similar to MS Word. The default file type is ODT (see the MS Word export types), which is similar to a DOC or DOCX file. It can also save files in XML, HTML, RTF, and a few variations of MS Word formats. And it runs on either Apple OS or Windows. (Note: I'm not advocating or advertising for LibreOffice. But I do find it useful for cross-platform editing.)
    • You could also use spreadsheet applications, like Excel (.XLS or .XLSX files), or Apple's Numbers (.NUMBERS files), or LibreOffice to generate MS Excel type files with default extension of .ODS.
    • And presentation applications, like Apple's Keynote (for .KEY files) or MS PowerPoint (for .PPTX files) or LibreOffice (for .ODP files).
    • Or you could use the MediaWiki itself. Just create a new page (with a name you would like to use for the article) and go for it.
  2. When you create the new page, the first thing you should do is include the line Category:Works In Progress at the top of your article. This puts the article in that category so the MRT SIG, and others, know that the page is not yet complete. You will see that it adds a reference to the bottom of the page indicating its inclusion in that category. You can click on the category to see additional notes and instructions on how the article creation process should work, as well as getting a list of other articles currently in progress. You may find one similar to your own.Then be sure to copy&paste from whatever application you used to draft the article to the wiki page, and make additional adjustments as needed.
  3. When you feel you are done and are happy with the draft, be sure to "Save changes...". Then use the buttons at the top of the page to "move" the page to a new page with the same name, but with the suffix " - Updated" appended to it. Then edit that page to remove the inclusion of the article in the Category:Works In Progress to be Category:Pending Review category. This lets the MRT SIG, and others, know the article is essentially complete. However, the MRT SIG folks would first like to review the article. This is requested so that a second set of eyes can review it for clarity, understandability, completeness, and such things. Think of it as submitting an article to a publisher or newspaper. They always review it for content conformance, suitability to their policies, grammar and vocabulary, and other things. We would like to do that as well, just to make sure we are publishing the best possible articles we can. Know that these articles are viewable by EVERYONE IN THE WORLD. So we need to do the best we can.
  4. When the article has had a review, and additional changes are requested or needed, the article will be "move"d back to a page with its original name, that is dropping the " - Updated" suffix, and the category inclusion returned to the Category:Works In Progress. If no further changes are needed, the page will be "move"d back to the original page, again dropping the " - Updated" suffix. And the inclusion in the Category:Pending Review will be removed.
  5. Finally, if it hasn't already been done, the article will be included in the various categories it should belong to. (See the MRT SIG Topics page for existing and recommended topics, but feel free to create your own.) This will allow it to be easily found by one and all.
Retrieved from "https://www.rcgrs.com/mrtwiki/index.php?title=DErik%27s_TP_2&oldid=533"