I have an initial job that could lead to regular future jobs for the right freelancer(s). I would prefer to build a working relationship with a short list of 2-3 people who are reliable and have a sense of personal quality control, but this task can be completed by one person if that is all I can find.
Before reading on, Markdown language will be an essential skill to complete this initial task. It is easy to learn but you will need to pick it up in your own time before starting:
[login to view URL]
A recent merge of three technical teams has lead to a requirement to merge three Wiki like sources. My team, who's initial wiki consisted of a set of Markdown files in a Git repository. Another team used Microsoft Onenote and another team used a bespoke CMS.
The wikis act as a technical knowledge base for all team members working on jobs i.e. if someone forgets how to configure a cisco router or how to add a rule to an iptables config or pull info from a remote machine with wmic etc.
A freelancer, recruited from the team using Onenote was asked to merge the Wikis last weekend. The html wiki was extracted with wget and converted with linux's html2text command. This resulted in messy formatting and extra unwanted characters in places. The markdown pages were pasted into the onenote as plain text markdown syntax.
Currently I now have a massive notebook with tabs and sections of duplicated content in mixed modes of formatting syntax and inconsistent styling (i.e. copy and pasted markdown, converted html and normal text on the same pages, with different styles in terms of display font and colours).
Going forward I want the whole wiki back in Markdown and versioned in Git so people can pull down and sync on their laptops and run locally via a command line server from one of the SSG's like hugo or jekyll... or better yet, just to grep
I will be sorting batches of pages from the messy onenote notebook and exporting them to either pdf, ms word or html (as per the freelancers choice out of the rather limited export options of onenote). I then require the freelancer to go through the exported documents, copying and pasting the content into a WikiJS site that was constructed just last night for this specific purpose.
Note: Knowledge of WikiJS is not essential. It is simply a static site generator with a markdown editor GUI built in (very straight forward). As a freelancer makes an edit or creates a file WikiJS syncs with a Git repo automatically. Using WikiJS means someone with no git knowledge can complete this task and multiple people can make edits easily without having to worry about pulling, committing and merging changes on files. Access to the direct Git repo CAN be provided to freelancers that can demonstrate correct working knowledge of interacting with a Git repo along side multiple people. If however things like committing and pulling of branches makes you nervous then I would prefer interaction via the WikiJS GUI only.
As the content is pasted into WikiJS the freelancer will need to edit the text on the page with the correct markdown tags for headers, tables and code blocks. The Wiki wont have any company sensitive information on it, it will just be pages and pages of curated command cheat sheets, technical information of system admin duties, web application testing methodologies, exam revision notes etc. While the understanding of these subjects is in no way required, a certain level of common sense will be needed in order to mark these pages up correctly with Markdown syntax. e.g. if you are to surround a bash script or Cisco router config in markdown code blocks you will need a certain level of nous to know where such items start and end.
Looking for someone that can do a quality job making intelligent editing decisions and putting themselves in the position of the person reading. I am not looking for someone to try and automate the process.