[moved on GitHub] Adding a "last updated" page with the latest changes [on doc]


#1

I found nothing about that, so I guess it is the right place to talk about that (and not create an issue onto hugo github)

  • It is difficult to know what are the latest improvements on the documentation.
  • I would like to add a page : “latest changes” with the latest X changes on documentation.
  • I’ve done that for my own documentation site and it is an appreciated feature.

If the team aggrees, let me know how I can add it, or better I should post my shortcode here.

I call {{% latest_changes 15 %}} for the 15 latest change

latest_changes.html

{{.Inner}}

 {{ $nombre_md := .Get 0 }}
<i>Here are the latest {{ $nombre_md }} changes.</i>

<table>
    <thead>
        <tr>
            <th>Date</th>
            <th>Direct access</th>
            <th>Location</th>
        </tr>
    </thead>

    <!-- this may be need some tweeking -->
    {{ range first $nombre_md (sort .Site.Taxonomies.categories.documentation ".Lastmod" "desc") }}

    <tr>
        <time datetime="{{ ".Lastmod" }}">
            <td>{{.Lastmod.Format "02 Jan 2006"}}</td>
        </time>
        <td>
            <a href="{{ .Permalink }}">{{ .Title }}</a>
        </td>
        <td>{{ $url := replace .Permalink ( printf "%s" .Site.BaseURL) "" }} {{ $url }}</td>
    </tr>
    {{ end }}

</table>

Let me know if this doesn’t belongs here.


List of last N git commits touching a content page
#2

I agree. I’ve scheduled on my to do list to browse the hugoDocs commits but that doesn’t always give me a clear picture.

So I’d also like to see a ‘latest changes’ page.

But I don’t think showing the last 15 changes is a good idea. If you look at the commits, on some days (see January 31) more than 15 changes were made. I think it makes more sense to show changes from the last 1 month or so.


#3

It’s a good idea.

  • A simpler range .Site.RegularPages.ByLastmod should work, I think
  • Also, on a slightly unrelated topic, I created a todo shortcode some time ago, and I had some plan to create a list of pages with that shortcode, would be nice to have a those listed as well.

So I suggest:

  • Create a new section (name?) with a simple list template?

We could continue the discussion in a PR or issue on GitHub.


#4

Done : https://github.com/gohugoio/hugoDocs/issues/339