-
-
Notifications
You must be signed in to change notification settings - Fork 1
Description
Ptracticalli has been invaluable to my own learning of Clojure and wider software engineering concepts & tools.
I am humbled and motivated when people tell me how useful it has been to them. I am also very thankful for the sponsorship I have recieved.
- static sites can be deployed without financial cost
Book & Blog content
mkdocs is a feature rich and mature tool for creating
NOTE: asciidoc is very powerful too and I did evaluate https://readsthedocs.com/ although I would have to convert 1,000s of markdown pages too ascidoc (which wasn't viewed as valuable use of time)
Managing content
GitHub projects
Projects has really evolved in the last yeat to be an excellent tool for managing workloads effectively.
A kanban board is used to capture and prioritise work
NOTE: I used GitHub mobile to capture this article idea and content as I wasn't near my computer. I wrote most of the copy in Neovim, running in Termux on my android smart phone
Book & Blog publishing
Mkdocs has a build command to generate a static site
A simple workflow is used to publish the book
setup-python action is used to provide an environment to build the website
The files foe the website are committed to gh-pages branch and the new version f the website is ready to view.
Standardising
Moving common documents to the Practicalli GitHub Org
- funding.yaml for sponsorship details
- licence ?
- GitHub workflows
Almost zero ?
Domain names aren't free
My time to create and maintain
- content creation
- content updates (new libraries, updated versions, etc)
- enabling other people to contribute effectively
- github workflows & actions
- security around github org
Metadata
Metadata
Assignees
Labels
Type
Projects
Status