Adding a new page to the wiki

Hi,

I added AmsterdamTop to the sitesdefinitions.json yesterday but I still can’t see it.

@EricZinda is there something else I should be doing?

Francis

Just missed the last step. There’s a page on what to do in the Garage section, here’s the relevant line:

Changing/Adding/Removing anything except the top level navigation in the site involves simply editing the file and re-running the workflow

But: It turns out one of the libraries we depend on is deprecated and failed when I tried to run the workflow for you. I’ll fix that and run it.

I thought it should run once every 24 hours, so I didn’t need to run it (if the library had been working), …

That is currently true for any changes to wiki pages that are already in the site, but not for changes to the site structure (adding of new pages, navigational changes, etc).

Really, it should automatically run for adds/removes/nav changes too since it is going to pick them up anyway the next time it detects an existing page change. I’ll fix that once I’ve got all the versions up to date.

Spoke too soon (and from memory instead of the code), sorry!

Yes, it will automatically update the site with any changes to the wiki. Since you added some Amsterdam pages that should have been enough. But: I just discovered that Github automatically disables workflows if nobody has changed the repository in 60 days. Since the https://github.com/delph-in/docs hasn’t needed any bug fixes, it hasn’t been updated in 60 days, so the daily workflow got disabled! Sheesh. I’m working on a workaround that makes the repository “immortal” so we don’t have this problem.

The amsterdam pages are now up, but you did add one (AmsterdamSchedule.md) that wasn’t actually in the wiki, so I had to remove that since it fails to deploy if non-existent changes are added.

Great, thanks for the update.

OK, I’ve updated the workflow so that it will update the docs repository on the 1st and 15th of every month regardless of whether the wiki has changed. That will reset the timer so we don’t hit this problem again.

Where is this document? Do we have documentation about this configuration?

We’re talking about the repository for the build system that builds the public documentation.

There’s a bunch of documentation on how it works in the Garage.