Have you always wanted to be more involved with Umbraco but have never really had the time to do it? Perhaps you've also been wanting to try writing documentation?
The Curator 'Internship' is a great way to see if writing and updating documentation is something for you! It's an unpaid internship, where you for 6 months join us, The Documentation Curators, to work with the Umbraco Documentation. You'll get to test your writing skills, play around with your favorite CMS and see what it's like being part of an open-source project - all the while you'll have direct access to some true Umbraco experts!
Intrigued? So keep on reading 😄
What is a Curator "Internship"?
- Time limit: 6 month
- Applications twice a year (March / September)
- Open to anyone
- Participating in curating the documentation, e.g. reviewing PRs, discussing issues and joining the bi-weekly (fortnightly) online meetings
- Working on a dedicated project matching the interns experience and interest, supported and mentored by the Curators, e.g. the “Getting Started” section or “Examine”
- Featured in “Introducing Spring / Autumn intern” blog post
- Learn how to contribute to Umbraco using Github
- Learn Umbraco good practice in unique way
- Discuss Umbraco implementation with experienced Umbracians and Umbraco HQ
- Be involved!
When does this internship start?
The first internship is planned to start on March 3rd 2020 and runs until the end of August 2020 - which makes it a total of almost 6 months. The next internship will then start on Tuesday, September 1st and run until the end of February 2021.
How many interns are you looking for?
We’re looking for 2 interns per 6 months.
When and how will I be able to apply for the internship?
We will open up for applications at the beginning of February 2020 - the exact date will be announced when we get closer - but I think you should start considering if this is something for you already now.
As to how: There will be an online form you will need to fill out - this form will be shared on all platforms at the beginning of February.
We expect to keep the application open for 7-10 days. After that, we’ll select 2 interns to join us for 6 months.
I’ve never done documentation before - will I be able to apply?
Anyone can apply for an internship as a Documentation Curator - that’s the whole point of the internship; It’s for everyone.
It doesn’t matter if you’re brand new to Umbraco, have been writing documentation your entire life or you’re already working for Umbraco HQ. As long as you want to try and work with the Umbraco Documentation, you should apply! We can vouch for the fact that you’ll learn something new 😄
Why an internship?
We have been approached by a few people over the last two years, offering to help more with the documentation and take on specific sections or tasks. Sadly it’s been really hard to help and support their efforts on a regular basis, coordinating with our ongoing goals and the time available from all of us. We felt an official internship might be a tentative way to encourage and support these bursts of community effort properly. And that, without permanently locking anyone into any lifelong commitments to document.
We joked recently when Jesper left to start the Package team that he’d just finished his internship with the Documentation Curators… so maybe, well maybe we should try this officially.
What kind of work will I be doing as an intern?
That entirely depends on you! We will have a list of tasks and projects that you could throw yourself into, but if you have a project or idea for the documentation that you would like to work on during your internship, with our support, we are open to your suggestions!
Oh, and you’ll of course also get to join our bi-weekly Curator meetings, where we talk about documentation related issues, pending PRs and much more.
How much work do you expect me to do?
It’s an internship, not a full time job. We expect to “see you” at our fortnightly meetings (every two weeks), but otherwise, the commitment is very flexible in terms of how many hours you’re able to put into contributing. The main thing, of course, is that you have fun! 😄
And that you feel you’re getting something out of being a part of a community team - whether that be personally or professionally.
Internship - does that mean I will get paid?
No. This is an unpaid internship, and it’s entirely on a volunteer basis.
Umm - What’s in it for me?
Oh, plenty! Let me list some of the benefits for you:
- You’ll contribute in a focussed way to an open source project and be lauded for your efforts
- You’ll get support and mentoring from the Documentation Curators
- You will get to go to a team gathering in Odense
- It will look great on your CV
- And last but not least, karma will look after you, somehow...
Projects and ideas for the "Internship"
Help get the current Documentation up-to-date for Umbraco 8
Even though Umbraco 8 was relased close to a year ago (February 2019), a lot of articles in the Documentation have yet to be updated.
We would to get some help on this! There are a bit less than 100 articles that still needs to be verified and possibly updated for Umbraco 8 as well.
Using https://our.umbraco.com/documentation/Contribute/file-naming-conventions, this should be a pretty straight forward task.
Verify the Editors Manual guide for Umbraco 8
The Editor's Manual is a package that have existed for many years for both Umbraco 4 and Umbraco 7. Essentially, it's a guide on how to work with content in the Umbraco Backoffice, and it is written primarily with editors in mind.
Recently, this manual was added to the Umbraco Documentation, and now we need it updated for Umbraco 8.
Anyone who's worked in the Umbraco Backoffice before will be able to take on this task. Even if you have little to no experience working with code or any kind of development, you will be able to tackle this task easily!
You can find the manual here: The Editors Manual
Define a new structure for the "Getting Started" documentation
Currently, the entire "Getting Started" section of the Umbraco Documentation is a bit, well, messy is a word that has been used by some.
The section contains information about everything from server setups to upgrading to a specific version to setting up custom logging. Perhaps this doesn't all qualify as articles that fall under the "Getting Started" category.
At our Curator meetings, we've talked about creating "User Journeys" instead, creating "Getting Started" documentation for people who are completely new to Umbraco and still have some articles for people who are experienced, but still rely on a quick guide on how to setup the Umbraco project initially.
Start working on a "Demo site" / Starter Kit
Wouldn't it be kinda neat to have an Umbraco site or a Starter Kit with examples and demos of the things, features and work-flows you can find in the Documentation?
In the Curator team, we've been talking about creating something like that for a long time. As we also have a lot of other things that needs attention, we would love it if someone would make the first move on this and get the ball rolling.
We will of course be available for feedback and for discussions whenever you need it!
Expand our documentation about using the Grid
The articles we currently have about how to use the Grid editor could be much better!
You can find what we currently have in the Getting Started section.
Work on creating a visual gallery of Backoffice components and directives
Over the past couple of years, we've had requests for more documentation about the backoffice UI.
Are you a UI expert, and do you love working with Angular and adding visual guidelines? Then this is the perfect task for you.