|
| 1 | +--- |
| 2 | +layout: reports |
| 3 | +title: "July 2021" |
| 4 | +--- |
| 5 | + |
| 6 | +Until today, I've been working on the basis of monthly reports for Encode. There's a reasonable track record there, with a history going back to 2016. |
| 7 | + |
| 8 | +However, it's often been difficult to work on these reports in a meaningful way. The rhythm feels wrong, I'm not able to recall sufficiently over such a long stretch of time, and I don't feel like I'm imparting useful information and visibility onto my work. |
| 9 | + |
| 10 | +Moreover, when added to the stresses of monthly accounting, invoices, and taxes, it ends up being *not fun*. |
| 11 | + |
| 12 | +Recently I've been struggling hard to keep up with them. |
| 13 | + |
| 14 | +So, let's make a change. |
| 15 | + |
| 16 | +## Weeknotes: Friday 16th July, 2021. |
| 17 | + |
| 18 | +This week I've switched over to writing weeknotes, I'm hoping that this'll work much better for me that the previous monthly approach. |
| 19 | + |
| 20 | +Some other tech folks, and their week notes... |
| 21 | + |
| 22 | +* I've long admired Aymeric Augustin's approach to his "[Multiple Template Engines for Django][1]" crowdfunded project, with it's weekly updates. That one is from way back in 2015, but I've often thought of it when looking for good examples of crowdfunded accountability in open source software. |
| 23 | +* Simon Willison writes [little and often][2], and it seems to work well for him. |
| 24 | +* Carlton Gibson has developed a [good lil' weekly writing routine][3], and I often feel like I've got a lot to learn from his approach to developing a healthy working balance. |
| 25 | + |
| 26 | +For now I'll collate my weeknotes into monthly pages, since that's [the existing structure][4] that I'm working with. |
| 27 | + |
| 28 | +The Encode website is [a Jekyll site, hosted on GitHub pages][5]. |
| 29 | + |
| 30 | +### HTTPCore, the directors cut. |
| 31 | + |
| 32 | +I've been spending a good chunk of time doing some in-depth work based on the core networking used by `httpx`. |
| 33 | + |
| 34 | +In order to provide good visibility onto my motivations and aims here, I've outlined the approach in [a GitHub discussion][6]. |
| 35 | + |
| 36 | +There's always a balance to be judged between starting fresh on something and iterating on an existing piece of work. My intuition here is that I've learnt enough from working on `httpx` and `httpcore` that it's worthwhile to be drawing on a clean slate here. |
| 37 | + |
| 38 | +### Future thoughts |
| 39 | + |
| 40 | +Some idling thoughts, worth putting out there perhaps, at least for my own recall. |
| 41 | + |
| 42 | +* Should I be pulling [MkDocs under the "Encode" umbrella][7]? |
| 43 | +* How can I be help maintain Django REST framework better, given that I'm spending a lot of in-depth time on HTTPX. Could the docs do with a refresh? Could we be more efficient by converting it to some of the structures and automations we've been learning from in other Encode projects? |
| 44 | + |
| 45 | +[1]: https://myks.org/en/multiple-template-engines-for-django/ |
| 46 | +[2]: https://simonwillison.net/tags/weeknotes/ |
| 47 | +[3]: https://noumenal.es/posts/ |
| 48 | +[4]: https://www.encode.io/reports/ |
| 49 | +[5]: https://github.com/encode/encode.github.io |
| 50 | +[6]: https://github.com/encode/httpx/discussions/1741 |
| 51 | +[7]: https://github.com/mkdocs/mkdocs/discussions/2442 |
0 commit comments