user73: I've been following this guide to build Plutus documentation locally.  The key line is -
[~/plutus] nix-build -A plutus-playground.haddock

This works fine, but I'm following the Pioneer Program and this requires checking out specific commits each week in order to follow the lesson.  When re-building the documentation, the resulting docs doesn't seem to reflect the tag that I've checked out.
My steps are -

git pull origin master to get the latest commits
git checkout of the tag specified for the week
rebuild the documentation using nix-build -A plutus-playground.haddock

I'm guessing that there is some caching going on that I'm not cleaning up but, if I compare the source files in the plutus dir they don't match the source that is linked to in the documentation.
Should mention that I have a superficial understanding of both nix and haddock.
Any guidance appreciated :)

user2201: I have been building the documentation with
[~/plutus] nix-build -A plutus-playground.haddock

following the Plutus Community guide and
nix build -f default.nix docs.site

from the Plutus repo and they both work as expected, generating the documentation for the current checkout.
The most probable cause for the issue is that git may not have updated as expected, i.e. throwing an error due to changed files in the local repo. That happened to me a few times when I was switching between the pioneer lecture weeks.
And in my opinion it is worth to set up the webserver as per the Plutus Community instructions, it makes the up to date documentation a great resource!

user4797: How to build local Plutus document:

cd plutus
nix-shell
nix build -f default.nix docs.site
cd result
python3 -m http.server 8081

Try open http://localhost:8081/haddock/plutus-ledger-api/html/Plutus-V1-Ledger-Value.html#g:1

73: <p>I've been following <a href="https://docs.plutus-community.com/docs/setup/buildDocumentation.html" rel="noreferrer">this guide</a> to build Plutus documentation locally.  The key line is -</p>
<pre><code>[~/plutus] nix-build -A plutus-playground.haddock
</code></pre>
<p>This works fine, but I'm following the Pioneer Program and this requires checking out specific commits each week in order to follow the lesson.  When re-building the documentation, the resulting docs doesn't seem to reflect the tag that I've checked out.</p>
<p>My steps are -</p>
<ul>
<li><code>git pull origin master</code> to get the latest commits</li>
<li><code>git checkout</code> of the tag specified for the week</li>
<li>rebuild the documentation using <code>nix-build -A plutus-playground.haddock</code></li>
</ul>
<p>I'm guessing that there is some caching going on that I'm not cleaning up but, if I compare the source files in the plutus dir they don't match the source that is linked to in the documentation.</p>
<p>Should mention that I have a superficial understanding of both nix and haddock.<br />
Any guidance appreciated :)</p>
 2201: <p>I have been building the documentation with</p>
<pre><code>[~/plutus] nix-build -A plutus-playground.haddock
</code></pre>
<p>following the <a href="https://docs.plutus-community.com/docs/setup/buildDocumentation.html" rel="nofollow noreferrer">Plutus Community guide</a> and</p>
<pre><code>nix build -f default.nix docs.site
</code></pre>
<p>from the <a href="https://github.com/input-output-hk/plutus/tree/master/doc" rel="nofollow noreferrer">Plutus repo</a> and they both work as expected, generating the documentation for the current checkout.</p>
<p>The most probable cause for the issue is that git may not have updated as expected, i.e. throwing an error due to changed files in the local repo. That happened to me a few times when I was switching between the pioneer lecture weeks.</p>
<p>And in my opinion it is worth to set up the webserver as per the Plutus Community instructions, it makes the up to date documentation a great resource!</p>
 4797: <p>How to build local Plutus document:</p>
<ol>
<li><code>cd plutus</code></li>
<li><code>nix-shell</code></li>
<li><code>nix build -f default.nix docs.site</code></li>
<li><code>cd result</code></li>
<li><code>python3 -m http.server 8081</code></li>
</ol>
<p>Try open http://localhost:8081/haddock/plutus-ledger-api/html/Plutus-V1-Ledger-Value.html#g:1</p>
