|
|
Wiki
Oct 20, 2020 8:10:25 GMT
Post by fidoedidoe on Oct 20, 2020 8:10:25 GMT
Same here, scripted that used to be a lot better. I let it slip lol. Well the current wiki needs an over haul. I think that is current priority when it comes to documentation. I think the devs are planning to keep 32bit for this release. So maybe start there? I've taken a look at the wiki section and yes, some items are a little stale (links to old forums as an example). I can throw some hours into this on a daily / weekly schedule (no fixed hours guarantee tho). To kick start something I'll need some guidelines. Like what is the vision for the wiki. what are the biggest pain points, what wiki style needs to be followed, what's the change review process etc etc. If someone wants to PM me perhaps I can visit some of these open questions. I'll need contributor access to the wiki to make change |
|
|
|
Post by ylee on Oct 20, 2020 18:20:23 GMT
I can answer most of these questions here. We really have no guidelines other than trying to keep it simple and accurate, good English and so on. I am not a grammar nazi so good English is whatever sounds good to me and others. The vision is to provide useful information particularly answers to common questions we get. The review process would be me or someone else reading and making edits, lol. Contributor access would be granted by Tristam. Go on Discord and ask him. Give him an email. I will tell him to go ahead and give you access. The wiki is WordPress. Keep the same style (css) as is used in all the articles. Hopefully, you know enough HTML and CSS to get by. Our so-called head of documentation is missing in action so just let me know what you are working on. Images should be updated or created using our default theme (moksha-arc-green) in most cases. It is our plan to stay with that theme with our next release (Bodhi 6.0). Feel free to add new articles if you wish, perhaps tho email me and asked about the topic. All help is appreciated so Thanks  |
|
|
|
Post by thewaiter on Oct 20, 2020 18:23:32 GMT
Maybe we can take some parts from Rogers BL 5.1 ebook. His English is excelent and info great.
|
|
|
|
Post by fidoedidoe on Oct 21, 2020 6:43:10 GMT
.Contributor access would be granted by Tristam. Go on Discord and ask him. Give him an email. I will tell him to go ahead and give you access. The wiki is WordPress. Keep the same style (css) as is used in all the articles. Hopefully, you know enough HTML and CSS to get by. Our so-called head of documentation is missing in action so just let me know what you are working on. Images should be updated or created using our default theme (moksha-arc-green) in most cases. It is our plan to stay with that theme with our next release (Bodhi 6.0). Feel free to add new articles if you wish, perhaps tho email me and asked about the topic. All help is appreciated so Thanks I'll get in touch with Tristam in the coming days. In the meantime I'll take a look at what the wiki contains. I'll most likely use use other resources as a point of reference with regards to content / structure, comparing what we have and what we need. I'll also spend a little time to looking through the forum / discord to see what questions are being raised and could be considered "quick wins" with regards to repetitive/questions on a common theme. Once I have made sense of what's there, I'll then approach you (DM in discord?) with an initial approach (limited to one page/thematic topic) before starting. I'm not familiar with WordPress but can't imagine it's too challenging, if I'm reusing an existing template (for styles, etc) - lol - famous last words!. If the WP change review process isn't obvious then I'll probably DM you with regards to how is should be worked (for example is the review process just that, or will you review, approve & publish - does WP have notifications of pending actions, or will we need to coordinate outside of WP, in discord or similar). EDIT: Currently I see a need for "reusable content blocks" for common items that get published many times to different pages, such as "system requirements" (ie: download page, installation, disto types etc etc). Is it safe to assume the Bodhi WP implementation uses Gutenberg page editor? Maybe we can take some parts from Rogers BL 5.1 ebook. His English is excelent and info great. I'll also take a look at the content within the ebook to see what can be reused (do we need to be mindful of copyright here? Can someone contact Roger to discuss reusing snippets of content?). Is the intent to keep the two resources (ebook/wiki) aligned or will the wiki ultimately be considered the "go-to" resource over the ebook or are they simply to be considered separate/discrete resources? |
|
