Although the topic of portfolios constantly circles around the tech writing space, discussions are almost entirely focused on the questions “What to include in my portfolio?” and “How do I create samples for my portfolio if all my work is covered by NDAs?”. In this workshop, we’ll actually create and publish a portfolio website by following docs as code practices.
The key takeaway from this workshop is that every participant walks away with a basic portfolio website published on the Internet. Additional takeaways: get started with SSGs, markdown, HTML + CSS, and GitHub.
What you'll need:
- Laptop – bring your computer, we’ll be doing some activities
- Text editor – Notepad++, Sublime Text, Atom, Visual Studio Code, etc. will do
- GitHub profile – Go to github.com and create a profile if you don’t have one yet.
- Jekyll – it’s one of the most mature static site generators, has detailed documentation and big community to ask for support, and it’s extremely simple to get started with it. jekyllrb.com/docs/installation/windows/ provides installation instructions for windows users and jekyllrb.com/docs/installation/macos/ provides installation instructions for Mac users.
Sveto joined the tech communication world in 2018 after spending several years in pre-sales and patent application drafting. He's especially interested in everything related to docs-as-code because it removes one of the major hurdles in every tech writer's job - getting those technical details from the subject matter experts. His on-the-job interests are mainly around developer documentation such as tutorials and API docs and creating videos.