fix: practitioner guide formatting and wordpress markup#24
Conversation
Signed-off-by: vee1e <vermalucky2004@gmail.com>
There was a problem hiding this comment.
Thanks for being thorough with converting this content!
Based on some of the image URLs in this page, it looks to me like the content for these practitioner guides also already exists in another CHAOSS git repo (https://github.com/chaoss/wg-data-science/blob/main/practitioner-guides/demonstrating-org-value.md). I must have accidentally misled you to work on this based on my own lack of knowledge that these pages could be pulled from the Data Science working group repo.
This group of pages can probably be skipped as far as the fixing of wordpress-injected information - we can likely reuse much of the same import process that we use for other imported pages.
If you'd like to compare your changes against the data science repository and possibly submit them there, that would potentially be a good place to put them so that they make it into the live site.
Since the version of the markdown you were editing from in this repo was exported from wordpress, contributing to the data science WG version would likely also help reduce the amount of reformatting bullet points and things that need to be done
Thanks for your contribution and apologies for the misleading info!
|
no problem @MoralCode! let me know which areas require attention and won't result in duplicated work, i'll be happy to work on them. currently targeting the posts but the sheer quantity of them will result in it taking a while to do and review |
|
Posts is a great start! feel free to just do one at a time if thats easier. I provided some feedback in #23 that may help. I also have a repo at moralcode/wp-hugo-conversion-helper containing scripts I wrote to bulk transform certain aspects of the site. Maybe after doing a few of these posts and understanding the patterns, it may be worth writing a script to automate the process for the rest of them (even if the migration is just a one-shot thing) |
|
heres a wikipage i started to help try and keep track of what content is imported and what isnt: https://github.com/chaoss/hugo/wiki/Pages-that-are-sourced-from-elsewhere |
|
i'll leave this PR open for a couple weeks in case you'd like to try and transfer your changes to the DSWG repo, but ultimately I don't see this being merged as-is. Apologies again for leading you down the wrong path (im also still somewhat learning how the CHAOSS website is put together) |
|
i think this can be handled later and in a seperate PR along with the entire folder from DSWG, i'll close this one out for now. |
Summary
This PR cleans up the formatting for the "Funding Impact" and "Demonstrating Organizational Value" practitioner guides. It removes legacy WordPress shortcodes, fixes HTML escaping issues, and improves the visual structure of complex tables using HTML for better layout control.
Changes
[vc_row]and[vc_column]shortcodes from both documents.practitioner-guide-demonstrating-org-value.mdto supportrowspanandcolspanfor a clearer prioritization matrix.<div align="center">.Files Modified
content/practitioner guides/practitioner-guide-funding-impact.mdcontent/practitioner guides/practitioner-guide-demonstrating-org-value.mdVerification
Sample Screenshots