Ignore /docs in cicd workflow

[msomp]

Hi Freddy and Team,

as I'm using GitHub Pages for documentation purpose, it would be great if the complete /docs path could be ignored in cicd.
Even if the docs folder (and subfolders) mainly contains .md files (which are already ignored), there may be also other filetypes which now may trigger an unnecessary start of cicd workflow.
/docs is btw a standard GitHub folder to built GitHub pages from selected branch.

Thanks.

[freddydk]

Sounds like a good idea.
Will probably make paths-ignore configurable and add /docs to the default.

[fvet]

Will there be future AL-GO support for auto-publishing source code documentation using aldoc.exe as part of the release action? (Incl. publishing documentation from the private source repo to a public github (pages) repo)

References

• AL-Go for GitHub Roadmap (view)
• https://svirlan.com/business-central-aldoc-docfx-generate-github-page-to-host-your-al-documentation/

[freddydk]

Yes, working on that - #760
Example: https://microsoft.github.io/bcsamples-bingmaps.pte/index.html

As you can see in the sample, it will create documentation for latest (work in progress) but also for shipped versions on the same site and you can determine how many versions you want.

Will come in preview later this month is the plan

[fvet]

Nice work, looks promising 👍

[freddydk]

Moved to roadmap

[TKapitan]

Hi @freddydk, this would help to solve one of the issues I have when assessing our move from Azure DevOps to AL Go. We have docs and a few other folders used by our internal tools that I'd like to exclude from CI/CD (they are changed quite often and won't impact BC so no need for us to run CICD).

[freddydk]

I think it makes a lot of sense to be able to control paths-ignore - will have a look at what I can do.