Comments (13)
Right, but we are conflating what users provide and how that gets translated into the http request/path. I'm saying that groups: "wg/whatever"
or even "whatever-wg" the could become /w3c/groups/webapps/wg in the request.
from respec-web-services.
Is there a chance that the shortnames clash may between WGs and CGs?
from respec-web-services.
yes - more specifically, there are already cases of clashing shortnames between cg/wg
from respec-web-services.
We presently add a -cg
suffix to clashing names. If we populate groups.json
using W3C API, there will be inconsistencies.
ReSpec doesn't expect users to tell us about the group type and only key users need to provide is shortname.
from respec-web-services.
fair enough - maybe this isn't practical. Maybe having a consistency check for wgs would still be useful?
from respec-web-services.
Is this something that can be done on W3C side?
I've only found 5 cases of clash:
['immersive-web', 109735, 'Immersive Web Working Group', 'WG'],
['immersive-web', 87846, 'Immersive Web Community Group', 'CG'],
['json-ld', 107714, 'JSON-LD Working Group', 'WG'],
['json-ld', 49174, 'JSON for Linking Data Community Group', 'CG'],
['timed-text', 34314, 'Timed Text Working Group', 'WG'],
['timed-text', 50119, 'Timed Text Community Group', 'CG'],
['wot', 63991, 'Web of Things Community Group', 'CG'],
['wot', 75874, 'Web of Things Interest Group', 'IG'],
['wot', 95969, 'Web of Things Working Group', 'WG'],
['xpath-next', 98025, 'XPath Next Community Group', 'CG'],
['xproc-next', 101103, 'XProc Next Community Group', 'CG'],
Is there a possibility that these group names can be changed?
FWIW, I liked how Publishing group handled this:
['publishing', 100074, 'Publishing Working Group', 'WG'],
['publishingbg', 97159, 'Publishing Business Group', 'BG'],
['publishingcg', 110591, 'Publishing Community Group', 'CG'],
from respec-web-services.
My understanding is that it is intentional that different groups may share the same shortname as long as they have different types - in practice, the shortname is used as a slug in various URLs, with the assumption that the group type is also incorporated to avoid overlap.
So I don't think that design constraint to be lifted.
from respec-web-services.
I see. I think we'll have to make the trade-off of requiring users to tell group type here. Maybe we can ask them to provide the type only in case of clashes. WDYT @marcoscaceres?
/w3c/groups/webapps -> no clash, return
/w3c/groups/wot -> clash. return 404
/w3c/groups/wot/wg -> okay
/w3c/groups/webapps/wg -> for consistency
And in ReSpec:
group = "webapps" | "wot/wg" | "webapps/wg"
Complicates code a bit, but workable I think.
from respec-web-services.
can we do:
"webapps" | "wot-wg" | "webapps-wg"
The "/" implies a hierarchy.
from respec-web-services.
Some group names already have a -
suffix, like "open-ui"
, so I wanted something other than -cg
. -
is kinda part of name and not a qualifier.
/
helps in keep this optional in the API URL. A :
could be good maybe? Though I already merged #115
from respec-web-services.
I could probably live with "/" but as a prefix... that would feel more natural "wg/webapps" for example.
from respec-web-services.
Optional first argument (here first pathname parameter) kinda smells bad.
/w3c/groups/wg/webapps === /w3c/groups/webapps (backward compatibility and we don't want users to always specify group type)
/w3c/groups/wot -> ambiguous
/w3c/groups/wg/wot -> okay
from respec-web-services.
Ah. I misunderstood. This sounds good to me!
from respec-web-services.
Related Issues (20)
- SyntaxError object missing from ECMAScript data? HOT 1
- Wrong patent link for i18n WG HOT 4
- Ambiguous last updated date
- Webref not longer using "master" HOT 1
- Support for TAG and AB in conf.group
- Include or link to developer's guide HOT 2
- Allow empty searches (when other things are given)
- Auto-update list of W3C groups HOT 1
- Adding closed WG-s to the "supported" list HOT 12
- Disambiguate groups
- xref: include http-headers
- respec.org certificate expired HOT 10
- Support CSS terms in API HOT 1
- Impossible to link to camelCase elements
- Migrate to Node 18
- respec.org is down HOT 1
- Groups not responding
- Docs are broken
- respec.org/xref suggests ambiguous linking text for overloaded functions
- Support linking "http-header" types
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from respec-web-services.