Entries tagged documentation

Filters: Type: entry × documentation × Sorted by date

12 results

Coping strategies for the serial project hoarder

I gave a talk at DjangoCon US 2022 in San Diego last month about productivity on personal projects, titled “Massively increase your productivity on personal projects with comprehensive documentation and automated tests”.

[... 3863 words]

3:47 pm / 26th November 2022 / documentation, productivity, talks, testing, annotatedtalks

Automating screenshots for the Datasette documentation using shot-scraper

I released shot-scraper back in March as a tool for keeping screenshots in documentation up-to-date.

[... 1810 words]

11:44 pm / 14th October 2022 / documentation, datasette, githubactions, shotscraper

Software engineering practices

Gergely Orosz started a Twitter conversation asking about recommended “software engineering practices” for development teams.

[... 1557 words]

3:56 pm / 1st October 2022 / documentation, softwareengineering, versioncontrol, zerodowntime, githubactions

Weeknotes: Building Datasette Cloud on Fly Machines, Furo for documentation

Hosting provider Fly released Fly Machines this week. I got an early preview and I’ve been working with it for a few days—it’s a fascinating new piece of technology. I’m using it to get my hosting service for Datasette ready for wider release.

[... 1005 words]

4:35 am / 26th May 2022 / documentation, projects, datasette, weeknotes, datasettecloud, fly, firecracker

Instantly create a GitHub repository to take screenshots of a web page

I just released shot-scraper-template, a GitHub repository template that helps you start taking automated screenshots of a web page by filling out a form.

[... 1177 words]

4:52 pm / 14th March 2022 / documentation, projects, githubactions, shotscraper

Weeknotes: Distracted by Playwright

My goal for this week was to unblock progress on Datasette by finally finishing the dash encoding implementation I described last week. I was getting close, and then I got very distracted by Playwright.

[... 892 words]

12:30 am / 12th March 2022 / accessibility, documentation, datasette, weeknotes, sphinxdocs, playwright, shotscraper

shot-scraper: automated screenshots for documentation, built on Playwright

shot-scraper is a new tool that I’ve built to help automate the process of keeping screenshots up-to-date in my documentation. It also doubles as a scraping tool—hence the name—which I picked as a complement to my git scraping and help scraping techniques.

[... 1802 words]

12:13 am / 10th March 2022 / documentation, projects, scraping, githubactions, gitscraping, puppeteer, playwright, shotscraper

Weeknotes: Datasette Tutorials

I published two new tutorials for Datasette this week, both focused at end-users of the web application.

[... 479 words]

5:35 pm / 27th February 2022 / documentation, datasette, weeknotes

Datasette on Codespaces, sqlite-utils API reference documentation and other weeknotes

This week I broke my streak of not sending out the Datasette newsletter, figured out how to use Sphinx for Python class documentation, worked out how to run Datasette on GitHub Codespaces, implemented Datasette column metadata and got tantalizingly close to a solution for an elusive Datasette feature.

[... 2164 words]

4:57 am / 14th August 2021 / documentation, github, sql, sqlite, datasette, weeknotes, sqliteutils, mypy, githubcodespaces