bcgovr icon indicating copy to clipboard operation
bcgovr copied to clipboard

add compliance audit file

Open MonkmanMH opened this issue 3 years ago • 5 comments

The bcgov github policies now require a compliance audit file; it would be handy to have a template accessible via {bcgovr}. Thanks!

MonkmanMH avatar Aug 16 '21 13:08 MonkmanMH

@MonkmanMH do you mean the yaml file? Can you provide a link to the policy or citation?

stephhazlitt avatar Aug 16 '21 16:08 stephhazlitt

Yes, the yaml is the one. Here's the link to the repo-mountie issue from the repo I created yesterday, that got me thinking about this feature. https://github.com/bcgov/census-wrangling/pull/4

Additional subfeatures to consider:

  • a choice option for the 4 status types
  • some data science-specific guidelines, since much of our work is not "application development"

Thanks!

MonkmanMH avatar Aug 17 '21 13:08 MonkmanMH

Thanks @MonkmanMH. There is a solid amount of maintenance to do on {bcgovr} in the near future, so will consider this at that time.

In the meantime, it is 'considerate' of {repomountie} that the COMPLIANCE.yaml is generated for users via a PR, so at least no manual steps required to add it for now (other than specifying the category in the comments).

I also wonder if bundling it into {bcgovr} will mean fewer users become aware of this policy step, the PR is almost an educational tool for users?

stephhazlitt avatar Aug 17 '21 16:08 stephhazlitt

I agree with @stephhazlitt since the repomountie PR takes care of almost everything and I found it helpful to learn that way.

But perhaps if generating that yaml file is an optional step in use_bcgov_github() then it could allow "advanced" users to start with the yaml file right away. I don't have the API off the top of my head, but one suggested implementation: use_bcgov_github() can take an optional parameter such as pia_status and stra_status with the options allowed being one of the values provided by the repomountie, so that the compliance yaml file is generated based on that. If these parameters are not provided, then no yaml file is created and the repomountie will give its friendly & considerate reminder PR :)

henry-ngo avatar Aug 17 '21 17:08 henry-ngo

I like that design, thanks @henry-ngo! 🙌

stephhazlitt avatar Aug 17 '21 17:08 stephhazlitt