Skip to content

fix: practitioner guide formatting and wordpress markup#24

Closed
vee1e wants to merge 1 commit into
chaoss:mainfrom
vee1e:fix/practitioners
Closed

fix: practitioner guide formatting and wordpress markup#24
vee1e wants to merge 1 commit into
chaoss:mainfrom
vee1e:fix/practitioners

Conversation

@vee1e
Copy link
Copy Markdown
Contributor

@vee1e vee1e commented May 12, 2026

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

  • WordPress Cleanup: Removed [vc_row] and [vc_column] shortcodes from both documents.
  • Formatting Fixes:
    • Resolved escaped HTML characters (e.g., smart quotes, dashes).
    • Converted complex Markdown tables to HTML in practitioner-guide-demonstrating-org-value.md to support rowspan and colspan for a clearer prioritization matrix.
    • Centered all images using <div align="center">.
  • pdated the "suggest edits" links in the footer of both guides to point to the correct Hugo repository paths.

Files Modified

  • content/practitioner guides/practitioner-guide-funding-impact.md
  • content/practitioner guides/practitioner-guide-demonstrating-org-value.md

Verification

  • Verified table layout matches the required design with merged cells.
  • Confirmed images are centered.
  • Checked that all raw WordPress markup is removed.

Sample Screenshots

image image image

Signed-off-by: vee1e <vermalucky2004@gmail.com>
@vee1e vee1e force-pushed the fix/practitioners branch from 1563682 to 19aec76 Compare May 12, 2026 11:58
Copy link
Copy Markdown
Contributor

@MoralCode MoralCode left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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!

@vee1e
Copy link
Copy Markdown
Contributor Author

vee1e commented May 14, 2026

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

@MoralCode
Copy link
Copy Markdown
Contributor

MoralCode commented May 14, 2026

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)

@MoralCode
Copy link
Copy Markdown
Contributor

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

@MoralCode
Copy link
Copy Markdown
Contributor

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)

@MoralCode MoralCode added the wontfix This will not be worked on label May 14, 2026
@vee1e
Copy link
Copy Markdown
Contributor Author

vee1e commented May 14, 2026

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

wontfix This will not be worked on

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants