Re: Request for Editor permission to add OpenAttestationRenderMethod

On Tue, May 14, 2024 at 3:21 AM Calvin CHENG (GOVTECH)
<Calvin_CHENG@tech.gov.sg> wrote:
> Other than that, I would propose for both myself @cxcheng, and my colleague Kyle @HJunyuan be given the permission to submit PRs.

Done (see Editors/Authors list at top of spec now):

https://w3c-ccg.github.io/vc-render-method/

> We can work together, but probably focus on editing our respective part of the render method spec.

Sounds good.

> Currently, the organization of the document is focused on SvgRenderTemplate2023. I propose we break it up to have each render method have its own section on “Data Model”, “Algorithms” (API is more appropriate for us),

Sounds good. Do you expect something like adding these sections?

Data Model:

* OpenAttestationSOMETHING
* OverlayCaptureSOMETHING

Algorithms:

* Render (OpenAttestationSOMETHING)
* Render (OverlayCaptureSOMETHING)

> “Security Considerations”, “Privacy Considerations”, “Internationalization Considerations” are better put into each method’s own section.

I wouldn't split these up for now because W3C presumes a single
section for each of those considerations. What we tend to do is give
general guidance, and then note which render methods that general
guidance applies to. For example, we might provide general guidance
for "Server-based Rendering" and then provide a Privacy warning noting
that doing so could result in the server viewing Personally
Identifiable Information. We'd then say which render methods are
covered by that privacy consideration.

The three of you have full rights to open PRs now. When you do so,
please 1) keep your PR simple and easy to review (a few paragraphs or
a section or two at a time), 2) keep your commit messages clean
(simple, active voice, under 50 characters, ideally). All the Editor's
will be pinged for a review, and my hope is that we can get things
merged quickly to just make sure we have new content going into the
spec at a rapid clip for the first few months.

-- manu

-- 
Manu Sporny - https://www.linkedin.com/in/manusporny/
Founder/CEO - Digital Bazaar, Inc.
https://www.digitalbazaar.com/

Received on Tuesday, 14 May 2024 13:50:20 UTC