Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Writing Day - Convince Community and Blog CTA #2094

Merged
merged 13 commits into from
Feb 12, 2024
93 changes: 89 additions & 4 deletions docs/conf/portland/2024/convince-your-manager.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,15 +2,18 @@
:og:image: _static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg


Convince Your Organization
==========================

Convince Your Manager
=====================
---------------------

Do you need help justifying why your employer should send you to Write the Docs? Don't worry – you're not alone.
Based on the experiences of some of our previous attendees, we've put together a sample email and list of resources below.
Feel free to adapt and share with your manager to show them the many benefits of attending!

Sample email
-------------
^^^^^^^^^^^^^

Remember to change the things in `[brackets]`!

Expand Down Expand Up @@ -45,8 +48,8 @@ Remember to change the things in `[brackets]`!

----

Resources
---------
Corporate Resources
^^^^^^^^^^^^^^^^^^^

When discussing how to pitch the conference, a few generally helpful tips emerged:

Expand All @@ -55,3 +58,85 @@ When discussing how to pitch the conference, a few generally helpful tips emerge
* Don't forget that one of the benefits to your attendance is that it raises the visibility of your company in the community. If your team wants a reputation for caring about their docs, having people at Write the Docs is a great way to do that.

In addition, it can be useful to share some info about previous conferences. View the `main page overview </conf/{{shortcode}}/{{year}}/#schedule-overview>`_ explaining what is Write the Docs, history and schedule overview.

Convince Your Community
-----------------------

Do you need help justifying why your community or employer should attend Write the Docs
and bring their project to Writing Day?

Don't worry, you're not alone. Based on the experiences of some of our previous attendees,
we've put together a sample email and list of resources below.

Feel free to adapt and share with your community or employer to show them the many benefits of attending!

Sample email
^^^^^^^^^^^^

Remember to change the things in `[brackets]`! You can edit this to work for more casual communication
methods, such as Slack, Discord, etc.

----

FROM: [your name]

TO: [your employer or community lead's name]

SUBJECT: Docs hackathon: Documentation Community Conference

I'd like to attend Write the Docs {{city}}, which takes place {{ date.main }}. This three-day
event explores the art and science of documentation, and covers a diverse range of topics
related to documentation in the software industry. I am particularly interested in Writing Day,
I believe this event can positively impact our project and community.

Writing Day is a community event modeled after the concept of “code sprints” or “hackathons”,
which are common in open-source conferences. The idea is to get a bunch of people together
and have them work towards a shared goal, in this case the goal is creating or improving
documentation or other related projects.

Costs:

* Conference ticket

Writing Day Benefits:

* Introduce our project and community to a new audience and demographic in our industry
* Get highlighted as a project in the conference blog and announcements (`Submit online <https://www.writethedocs.org/conf/portland/2024/news/call-for-projects-writing-day>`_ by *March 28, 2024* to be included)
* Onboard documentation enthusiasts to increase the likelihood of post-conference contributions
* Strategically tackle documentation tickets and requests
* Update existing documentation
* Peer review new and existing documentation

Conference Benefits:

* Exposure to the latest ideas, techniques, and tools for software docs
* Opportunity to learn from the best doc teams in the industry
* Building professional connections with other documentarians

Bringing our project to Writing Day benefits us as a community. It gives us the opportunity to
improve our documentation and create a more inclusive project. Check out the `Call for Projects <https://www.writethedocs.org/conf/portland/2024/call-for-projects-writing-day>`_ for more information.

Thanks in advance,
[your name]

----

Writing Day Resources
^^^^^^^^^^^^^^^^^^^^^

When discussing how to pitch Writing Day, a few helpful tips emerged:

* Highlight a few specific projects that attended a previous Writing Day, such as `Writing Day, Portland 2023 <https://www.writethedocs.org/conf/portland/2023/writing-day/#project-listing>`_.
* If your community is looking for regular documentation contributions, Writing Day
is a great place to onboard potential contributors and editors.
* Don't forget that one of the benefits to your attendance is that it raises the
visibility of your community and/or company in the Write the Docs community.
If your project wants a reputation for caring about their docs, having people
at Write the Docs is a great way to do that.

You may find it useful to review the `tips and tricks for leading a project <https://www.writethedocs.org/conf/portland/2024/writing-day/#lead-a-project>`_ at Writing Day.

In addition, it can be useful to share some info about previous conferences.
View the `main page overview </conf/{{shortcode}}/{{year}}/#schedule-overview>`_ explaining what is Write the Docs, history, and schedule overview.


48 changes: 48 additions & 0 deletions docs/conf/portland/2024/news/call-for-projects-writing-day.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
:template: {{year}}/generic.html
:og:image: /_static/conf/images/headers/{{shortcode}}-{{year}}-opengraph.jpg

.. post:: Feb 12, 2024
:tags: {{shortcode}}-{{year}}, writing day, projects, oss projects

Announcing the Writing Day Call for Projects
============================================

Hey folks! We were so thrilled with your response to Writing Day last year that we are launching
a `Call for Projects submission form <https://forms.gle/5WPN8MGCKzKqZBWU6>`_!

For projects submitted by March 28, 2024, we'll highlight your project on our social media, as we learned last year that projects that submit their information before the conference have higher attendance. In fact, perusing project details encourages documentarians to join us earlier, stay longer, and check out multiple projects.

Our attendees are curious and want to know about you, your project, and your community - so
let's give the people what they want!

You are of course welcome to submit and announce your project at Writing Day. This is a time honored
tradition and we appreciate all of our projects.

Call for Projects
-----------------

Bringing your project to Writing Day is a wonderful way to introduce your mission and community to
Write the Docs attendees.

The Write the Docs conference has many enthusiastic attendees. These attendees, documentarians, want
to learn new technologies, sharpen their skills, and add to their portfolios. The world of open
source has a seemingly endless number of wonderful open source projects. Documentarians want to write
the docs, your open source project docs.

We are looking for community/OSS projects for our in-person Writing Day at the Portland conference on April 14.

The `Call for Proposals submission form <https://forms.gle/5WPN8MGCKzKqZBWU6>`_ is open until *11:59 PM, March 28, 2024 PST*.

(If you’d prefer not to attend an in-person event due to COVID-19 or any other reason, keep an eye out for our
Atlantic conference held online in timezone selected for accessibility.

Writing Day Resources
^^^^^^^^^^^^^^^^^^^^^

You don't have to be a developer advocate, community manager, or project lead - though you're all
welcome. Anyone with enthusiasm for their project and community is welcome to bring it to Writing Day!

If you’re excited about Writing Day and want to lead a project but not sure where to begin, we have `tips and tricks for project leaders <https://www.writethedocs.org/conf/portland/{{year}}/writing-day/#lead-a-project>`_ to help maximize your experience.

If you need additional information to advocate for Writing Day in your community, or help persuading
your corporate benefactors on the benefits of attending Writing Day, see the `Convince Your Community <https://www.writethedocs.org/conf/portland/{{year}}/convince-day-manager/#convince-your-community>`_ resource.
18 changes: 11 additions & 7 deletions docs/conf/portland/2024/writing-day.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Attendees are invited to submit their project pre-conference! It's a great way t
- Project leads: Attendees bringing ideas, content, or OSS projects to work on with contributors.
- Contributors: Attendees looking to contribute to various content projects.

**Here are some examples of projects that you might see at the conference:**
**Here are examples of projects that you might see at the conference:**

- Open-source software documentation
- General documentation writing
Expand All @@ -32,7 +32,7 @@ Attendees are invited to submit their project pre-conference! It's a great way t
- Love letters
- The Documentarian Manifesto

`View 2023 Project List for ideas! <https://www.writethedocs.org/conf/portland/2023/writing-day/#project-listing>`_
If you find specific examples helpful, check out the `Portland Writing Day 2023 project list <https://www.writethedocs.org/conf/portland/2023/writing-day/#project-listing>`_.

Writing Day Schedule
--------------------
Expand All @@ -43,7 +43,7 @@ Writing Day is an all day event that is designed with flexibility in mind. Feel

- Morning Introduction: The coordinator welcomes everyone and gives a Writing Day overview.
- Project announcements: Project leads are invited to give a 2 minute project summary.
- Session 1: Projects and co-working begins
- Session 1: Projects and co-working begins.
- Lunch Break
- Project announcements: Project leads are invited to give a 2 minute project summary, starting with the afternoon-only projects.
- Session 2: Projects and co-working reconvene.
Expand Down Expand Up @@ -92,12 +92,16 @@ Check out the project list! Keep in mind that some attendees choose to announce
- **Check out our guide to writing documentation.** Our `beginners guide <https://www.writethedocs.org/guide/writing/beginners-guide-to-docs/>`_ will help you get started, and give you some ideas for how you can contribute to a project.
- **Ask people for help if you have a question.** If at any time you get stuck with new concepts and tools, you are in a room full of friendly people from diverse backgrounds and experiences. If you are not sure who to ask, ask the Welcome Wagon or Registration staff or volunteers. We will help you find someone!

Submit Your Project
-------------------
Call for Project Submissions
----------------------------

We encourage you to submit a Writing Day project in advance! We'll open project submissions in February/March. **Projects submitted by April 5 are promoted in our pre-conference Writing Day blog post and email.**
Based on the positive response to Writing Day during Portland 2023, we strongly recommend that you `submit your Writing Day project in advance <https://forms.gle/5WPN8MGCKzKqZBWU6>`__! **Projects submitted by March 28, 2024 are promoted in our pre-conference Writing Day blog post and email.**

Walk-on projects are always welcome. You always have the option to bring your project, sign up on site, and announce it during Writing Day.
Learn more in our `Call for Project Announcement <https://www.writethedocs.org/conf/portland/{{year}}/news/call-for-projects-writing-day>`_.

As usual, walk-on projects are always welcome. All attendees always have the option to bring a project, sign up on site, and announce it during Writing Day.

If you need additional information to advocate for Writing Day in your community or organization, see the `Convince Your Community <https://www.writethedocs.org/conf/portland/{{year}}/convince-day-manager/#convince-your-community>`_ resource.

Project List
------------
Expand Down
Loading