-
Notifications
You must be signed in to change notification settings - Fork 3
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Revise and simplify top level explainer. #56
base: main
Are you sure you want to change the base?
Conversation
high-level-api.md, use web-map-doc in preference.
I've been trying to update this explainer in light of @zcorpan's 2020 review. That review, and the explainer itself, didn't have access to research that was done by @Malvoz and @nchan0154 for the 2020 workshop, and later research by @zcorpan and others. I believe that those two project provide the most authoritative (to date) rationale for standardizing web maps, and I would like to include them as part of the "problem statement" (Step 0. Describing the problem: What specific problem are you trying to solve. Who are you trying to solve it for?). The explainer should keep it simple and short Reviewing those resources, I found some guidance on proposing new platform features, and what constitutes a good problem statement and list of consequent requirements, and it seems quite simple, actually. I started copying the form of requirements enumeration there and it started to get interesting. I'm not sure if it fits into the "explainer" format, but if you have any comment on this list, I would love to hear it. I will probably adapt it a bit to the explainer introduction. (1) A search crawler wants to index web pages according to the location(s) of information in the page. (2) A screen reader user wants to know what locations represented on a web map are closest to them, or are considered most “important” to the web map author. (3) A web developer wants to represent, style, and programmatically manipulate real-world locations in their page using HTML, CSS and JavaScript, according to WCAG (4) A government data provider wants to share authoritative, accessible and interoperable map location information on the web as a service, so that all users have access to the most up to date information (say, in an emergency) |
+1 on the above format. |
No description provided.