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

Add initial Feb 2022 newsletter #151

Merged
merged 5 commits into from
Feb 8, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 1 addition & 3 deletions _themes/rtd-blog/social.html
Original file line number Diff line number Diff line change
Expand Up @@ -46,12 +46,10 @@ <h4>Thank you!</h4>
<!--End mc_embed_signup-->


<!-- Jobs
<h3> Read the Docs is hiring </h3>
<ul>
<li><a href="https://blog.readthedocs.com/job-frontend/">Front-end Developer</a></li>
<li><a href="/hiring/job-product-developer/">Product-focused Python Developer</a></li>
</ul>
-->

<h3> Follow us </h3>

Expand Down
11 changes: 7 additions & 4 deletions hiring/details.rst
Original file line number Diff line number Diff line change
Expand Up @@ -26,23 +26,26 @@ given the grant work that will be part of this role.
**We realize that you might not know all of our tools,
please reach out if you think you'd be a good fit.**

We are a fully remote company and our team is currently based in the US, South America, and in Europe.
We are a fully remote company and our team is currently based in the US, South America, and Europe.
We hope to work with people that are based in timezone where we have some overlap with the entire team,
which is around UTC-8 to UTC+1.

which is around **UTC-8 to UTC+1**.

Structure
---------

We are currently only able to offer contracts to work on the project.
We are currently only able to offer a contract to work on the project.
We would contract you to work 4-5 days a week.
Half of our team works 4 days, and the other half works 5 days,
and we are happy to be flexible with whatever works best for you.
We do offer the ability to expense work-related computer equipment,
home office gear, and other approved expenses.

After an initial interview,
we normally do a small paid project (4-6 hours) to see how we work together.
Assuming that goes well,
we will offer a contract until the end of the calendar year.
This contract then would be renewed yearly,
along with evaluating pay and other benefits.

The pay rate will vary with experience and the number of days worked.
As a small, self-sustaining open source project we are not able to pay as much as large companies.
Expand Down
2 changes: 1 addition & 1 deletion hiring/intro.rst
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
Thanks for your interest in working at Read the Docs.
We are a small team of 5, and we're looking to add 2-3 people in 2021,
We are a small team of 7, and we're looking to add 1-2 people in 2022,
and we'd love for you to be one of them.

About the company
Expand Down
85 changes: 85 additions & 0 deletions newsletter-february-2022.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
.. post:: Feb 8, 2022
:tags: newsletter, python
:author: Eric Holscher
:location: BND

.. meta::
:description lang=en:
Company updates and new features from last month,
current focus, and upcoming features in February.

Read the Docs newsletter - February 2022
========================================

Welcome to the latest edition of our monthly newsletter, where we
share the most relevant updates around Read the Docs,
offer a summary of new features we shipped
during the previous month,
and share what we'll be focusing on in the near future.

Company updates
---------------

- We have mostly finished migrating Read the Docs for Business users to Cloudflare for SSL.
There are lots of interesting features this will enable,
so stay tuned for updates there.
- We're sad to announce that `Juan Luis`_ has moved on from Read the Docs as our developer advocate.
The work he did was vital towards getting our :doc:`CZI grant </czi-grant-announcement>` mostly finished, and we thank him for his time spent bettering the RTD, Sphinx, and docs community.
- On a related note, we're going to be hiring again soon to fill another position.
It will be a bit different and likely a product-focused Python development position.
If you're interested, please `let us know`_.

.. _let us know: mailto:hello@readthedocs.org?subject=Job%20Posting

New features
------------

In January we continued to work on refactors and internal changes.
Among the major user-facing changes:

- We fixed a bug in Bitbucket that didn't allow us to properly sync user permissions.
This resulted in a few support requests, but has now been resolved.
- We improved our ability to mark projects as non-spam,
so that we can validate a project isn't spam and then make sure it doesn't get flagged by our automated system.

You can always see the latest changes to our platforms in our :doc:`Read the Docs
Changelog <readthedocs:changelog>`.

Upcoming features
ericholscher marked this conversation as resolved.
Show resolved Hide resolved
-----------------

- Cancelling a build is a long requested feature, and we're getting close to implementing it.
- We're looking at tracking 404 pages in our project analytics,
so that projects can easily fix up missing or outdated page links.
- We are hoping to launch our revamped landing pages this month,
which will give our front page a much needed refresh.
- We are working to define a policy for canonical docs and cloned versions,
so that we can more easily remove outdated docs for projects.
- We're working to investigate supporting a CDN on Read the Docs for Business,
which will be an exciting new feature for our users there.
- We're `looking at how to support <https://github.com/readthedocs/readthedocs.org/issues/8811>`_ multiple ``readthedocs.yml`` files in a single git repo.

Possible issues
---------------

We continue to see a good pace of development on the Sphinx project,
with them adding support for docutils 0.18,
and removing jQuery in a major refactor of their Javascript.
We're working to ensure that our theme and other parts of the ecosystem don't break with these changes,
and trying to be procative to address any possible issues.
That said,
there will likely still be some issues that sneak through with the release of Sphinx 4.5 (docutils upgrade) and Sphinx 5.0 (JS refactor).

----

Considering using Read the Docs for your next Sphinx or MkDocs project?
Check out `our documentation <https://docs.readthedocs.io/>`_ to get started!

.. Keeping this here for now, in case we need to link to ourselves :)

.. _Ana: https://github.com/nienn
.. _Anthony: https://github.com/agjohnson
.. _Eric: https://github.com/ericholscher
.. _Juan Luis: https://github.com/astrojuanlu
.. _Manuel: https://github.com/humitos
.. _Santos: https://github.com/stsewd
ericholscher marked this conversation as resolved.
Show resolved Hide resolved