Where answers come from

Some pages can ask a language model questions. Set this up once; your choice is remembered in this browser for the whole site.

Model source
Use another source instead

Smallest-to-largest weight downloads. Qwen3.5 0.8B is our starting choice for page Q&A. GPU estimates are not total RAM: leave room for the browser, context and temporary buffers. Hardware changes speed and capacity; answers still need checking.

Session-only loading avoids saving model weights, uses extra RAM and downloads again after unloading. Turn it off to save downloads. Delete-data-on-exit or private browsing may impose a much smaller storage limit than the displayed estimate.

You sign in on OpenRouter; it gives this page a key for your account.

A free account does not make every model free. Choose a model with a listed :free variant; merely adding that suffix does not create one. Check free-model availability and pricing.

Chat

AI assistant, not Shawn Hartsock. It does not speak for him.

Inspect the page excerpt

Up to 4,800 characters, not the whole site. Recent conversation turns are retained within the model’s context limit.

Ask about this page, or just say hello.

Ready when you are.

Not saved or uploaded automatically. Closing keeps this conversation in this tab; changing pages starts a new one. Model replies can be wrong.

Documentation is live

Originally published .

This week I’ve been dealing with documentation for pyVmomi. I decided to go with the Google Python Documentation standard for this current set of docs because the Google standard is very human readable and renders reasonably well in GitHub. The docs are live on GitHub now.

However, when it comes to the most useful documentation standard for inline documentation the Sphinx standard has too many benefits to ignore. In particular if you want code completion using tools like Eclipse or IntelliJ you need to have Sphinx docs and those have to be on concrete static classes.

So, for actual inline code comments I want to enforce Sphinx’s standard with type hinting. These kinds of hints are very valuable for static code analysis tools and you simply can’t get that with any other standard at present.

My next set of tasks will be to build up the testing infrastructure around pyVmomi, once that is done we’ll be able to leave behind the timid and slow progress stage we’ve been stuck in. This will have to happen sooner rather than later. The project will officially “launch” at VMworld coming up in August and we’ll need to be ready for the additional attention that will bring.

Part of this week’s documentation effort has been trying to find ways to present developer documentation and developer guides to make sure that new developers don’t get mired down too badly. I’ve been years off the speakers circuit now and I think it shows. My presentation is a bit choppy but I hope you’ll find it useful.

This video that I’ve prepared walks through the code contribution process from fork to *pull request. *It assumes you have a previously setup GitHub account. This is the first time I’ve done one of these in a good long while and I was surprised by how badly the text blurred. I may update this later.

When you submit a pull request it should only have the commits listed in it that you wrote if it doesn’t then something went wrong! You’ll have to start over by branching from master and cherry-picking your commits. Git has a learning curve but it’s worth learning and it’s worth spending time with to get things down properly.

If you have a good contribution and you’re really stuck, I’ve already pulled and cherry-picked some key submissions from other people into my local git repos. I try to preserve the code authorship marks on the patches so that you can find your committer credits on the source repository later.

Now that we know the basics of how to contribute, I’ll take some time and work on precisely what we’re going to work on and when we’ll release it.

More on that next week…

Explore the map · Browse by topic and date