12

Preface

This project has sprung up from the larger discussion as a standalone effort to make Google Apps Script tags, their excerpts, and wikis more fine-grained, detailed, and resource-full for them to become a viable alternative (alongside canonical Q&As) to long and hard to navigate community wiki reference lists or collections.


Proposal

I propose to coordinate the effort of updating tags and wikis for Google Apps Script-environment related Q&As here as a standalone project to improve visibility and provide a place for discussion of such changes to help reach consensus on trickier edits and involve the collective expertise of the community.

The proposal as it stands now is limited to the effort of the Google Apps Script community to test the water, but it would be great if we could expand the discussion to other areas that might need it as well.

We now have a chat room!


Useful queries

The queries below are meant to ease the process of monitoring tags and related questions (square brackets mean configurable [parameters]):

  1. Tags, their wikis, excerpts, and synonyms that match [search term]
  2. Tags without tag wikis or excerpts
  3. Tags with pending wiki suggested edits
  4. Well-received questions with [tag] and [text] (configurable)
  5. Percent of questions tagged with [tag] and [low] views
  6. Questions with [tag] by users with reputation higher than [threshold]
  7. Questions with [tag] with score over [threshold] (by period)
  8. Questions with [tag] that was later removed + version including initial state of the question
  9. Questions with [tag] that have the [tag] as title prefix
  10. Questions with [tag] that are tagged with Google API or product tag
  11. Questions with [tag] that are also tagged with another [tag]
  12. Questions with [tag], no comments and [without] answers
  13. Top users of the [tag] by positively received and non-closed posts
  14. Trend of questions with [tag] and positive score
  15. Trend of the average score of upvoted answers on upvoted questions by year of creation
  16. Trend of questions with [tag] that [do not] contain a [term]
  17. Trend of questions with [tag] that are closed as duplicate

All tags GAS

Google Apps Script main tags with google-apps-script-* prefix:

Related tags with gs-* prefix:

Cleared.

Closely related tags:

(see Google App Engine URL Fetch Service)

APIs that have corresponding Advanced Google Services:


Pending tasks and recent updates

a lot of the tasks moved to the community chat room for greater velocity, so this question now includes long to middle term tasks.

The list contains pending changes and issues that need care. Please help if you can or participate in the discussion (done tasks can be found in timeline):

Pending renaming / retagging / merging requests

  1. Merge tag [google-hangouts] with [hangout]

As of October, 6th, Google announced the renaming of G Suite to Google Workspace, therefore we now have a big project of updating affected tags on our hand. Currently pending requests are:

  1. Rename [google-apps-marketplace] tag
  2. Remove synonym [gsuite-addons] from [google-apps-script] and rename [gsuite-addons] to [google-workspace-add-ons]

Question tagging

  1. See query about questions that are tagged with a tag and have it duplicated in the title as prefix (cleanup needed)

Tag wikis and excerpts

Currently cleared

Synonymizing (voting requests)

Currently Cleared

If you have reservations or want to discuss, join the community chat room. Each synonym undergoes a preliminary discussion and internal voting process amongst experts and is decided by a majority vote.


Related resources

  1. Help articles on: excerpt editing
  2. Pending tag synonyms review page
  3. Writing a good tag wiki
  4. Tutorials in tag wikis discussion
  5. How to gather support for tag synonyms?
14
  • Why you think that it's confused with gae-quotas? Why there should be two different tags (all Google Apps Script projects have a Google Cloud Project and Apps Script and App Engine are part of Google Cloud)
    – Wicket
    Commented Jun 17, 2020 at 18:33
  • 1
    "google-services" could be misleading as Google offer other services than "[Google Apps Script] built-in Google Services"
    – Wicket
    Commented Jun 17, 2020 at 18:40
  • Hi @Rubén - thank you for your comments! Regarding quotas - I would argue that quotas for google services and google-app-engine quotas are two very distinct types of quotas . As for the confusion - I already retagged a couple of q. that were gae-tagged, but are about quotas for services. The second reason is that a search like [this one]([google-apps-script] [quota]) shows that there should be a more specific tag for service quotas than just "quota" tag. Also, during...
    – 0Valt
    Commented Jun 17, 2020 at 19:10
  • ...the past year, I started to notice that almost all questions that ask for assistance in understanding "service invoked too many times", etc or regarding available quotas commonly refer to service quotas specifically (not even mail sending limits). Regarding "google-services" - I don't like the wording very much as well, but that how they are called - "Quotas for Google Services" and all of them refer to built-in services. That said, I am not entirely sure these quotas refer only to built-in services, but AFAIK advanced services have their own, API-specific quotas.
    – 0Valt
    Commented Jun 17, 2020 at 19:17
  • Re:GAS editor wiki update "do not use" part - I think I agree that as it stands now "do not use for debugging help" is narrowing the scope (I used it in the same sense that help article on on-topic questions uses it uses it, at least as far as I think I can grasp one) - since it is not approved yet I will change that. Sometimes it does indeed refer to debugging via script editor (although one might suggest adding a specific tag for Apps Script debugger built into the editor which we also lack, but that's likely not worth the fragmentation)...
    – 0Valt
    Commented Jun 17, 2020 at 19:24
  • ...And will also add (well, make more explicit, as the reference is there already) the debugger reference to the wiki as well - missed it when updating and mention that the tag should be used for debug mode.
    – 0Valt
    Commented Jun 17, 2020 at 19:27
  • @Rubén - Re:editor wiki again - updated the suggestion to include the missed use case and reworded "do not" first point and tried to both keep the idea that the tag should not be used for help with code that just happens to run "in" the editor (have seen this pattern several times). See this one, for example (given what the question is about, I now consider adding a warning about not using it for document editors and permissions in general)
    – 0Valt
    Commented Jun 17, 2020 at 19:54
  • 1
    Now I'm thinking that the google-apps-script-editor proposed tag wiki deserves it's own Q/A... (perhaps its own chat room)
    – Wicket
    Commented Jun 17, 2020 at 20:04
  • IMHO google-documentation, google-services-quotas, advanced-google-services look to be meta-tags and prone to be "abused" as the people who use google-apps-script is a very small community compared to the community that uses a Google product/service/API. I think that we should use google-apps-script- something / gs- something-that-exceeds-the-35-chars-limit
    – Wicket
    Commented Jun 26, 2020 at 16:49
  • @Rubén - yes, I considered this route, and my concern was that google-apps-script-quotas and gs-advanced-services can be confusing as people won't know these conventions we have (assuming the least amount of effort). Regarding google-documentation - this one I added to 1. Not create dissonance with already existing convention and 2. GAS will limit the meaning to documentation on GAS while the question may concern an advanced service docs or even REST API. To sum up, I think that using the same names quotas and services are called in official documentation at least gives us a chance that...
    – 0Valt
    Commented Jun 26, 2020 at 17:48
  • ...users will be somewhat familiar with how they are called (and I think that those who don't read the documentation at all are beyond saving by definition - after all, appscript keeps popping up instead of google-apps-script. To elaborate some more on google-documentation - I was answering a question that fell under the category of documentation issues
    – 0Valt
    Commented Jun 26, 2020 at 17:50
  • I propose leaving them as is (and I will be adding usage info for those that do not have one as soon as I get some extra time to spare - or maybe someone else will get to them first) and see what happens (I am happy to design a SEDE query for long-term management) - if there is any sign of abuse, I will be the first to create a tag under the guidelines you mentioned and request synonimization of the current tag. As for any GAS tags we are missing (not sure if we do, though) - I totally support your way of thinking and these were my guidelines as well.
    – 0Valt
    Commented Jun 26, 2020 at 17:56
  • I disagree with the currently proposed excerpt and wiki of advanced-google-services as they are wrote as if they were part of a site about google-apps-script. IMHO in the context of Stack Overflow, they make the tag look as a meta tag.
    – Wicket
    Commented Jun 26, 2020 at 21:52
  • @Rubén - could you please clarify what you mean by "part of a site"? Re:wiki excerpt - I would argue that the disambiguation with built-in services and REST APIs is the "when" of the excerpt. Probably lacks in "why", I agree - happy to rewrite if we can find a common ground - maybe chat? I also oriented on the success of: this and this, but maybe I missed the mark here
    – 0Valt
    Commented Jun 26, 2020 at 22:06

5 Answers 5

2

Following this post and a lot of discussion within the community, It was decided that most branches of needed to go. But there doesn't seem to be any combined record of these matters in the meta. Therefore, I've decided to add this answer mainly to record the actions done by the community hitherto.

The discussion was mainly held in the official community chat room for the last three months. Though the initial decisions were disputed by one user, the user left further discussions in the chat room of their own accord and All decisions were unanimous thereafter. The initial decisions were unanimous, save one user mentioned above.

The following tags were deemed unnecessary by the community and synonymized to the parent tag: . Some of these tags have separate meta posts/voting chat rooms associated with it. They are linked below, if available.

  1. - Meta post, Vote room

  2. - See 1 above

  3. - See 1 above

  4. - Meta post, Vote room

  5. - See 4 above

  6. - Meta post

  7. - Related Meta Answer and comments chain

  8. - Related to 7

  9. - Related to 7

  10. - Related to 7

  11. - Related to 7

All synonyms proposals were discussed in official chat room before synonymizing(even without meta posts or vote rooms). Anyone can search the relevant tag they're interested in - in the official chat room for the recorded discussion.

4

The main language has way too many branches. I believe most of them are unnecessary and should be debranched/merged into the main tag itself. The following factors should be considered when creating new branches or consolidating old branches:

  • Concept division: Is the proposed, a sufficiently different concept to warrant a separate tag? This should be voted upon by subject experts/badge holders of the tag.

  • Alternatives: Could a be sufficiently described by a other tag or a couple of LEGO tags? LEGO tags, in general, have pretty good organic growth built in and should be preferred where possible. Eg: Prefer + over .

  • Quantity: Percent of questions that are or will be tagged with the . And whether it is significant enough to warrant the tag division.

  • Organic growth:

    • Whether is added naturally(organically) by question askers or Was it added inorganically by tag editors?

    • Organic growth is preferable to inorganic growth. This depends on the

      • Tag name: Whether the name is naturally recognizable as a specific concept to new users or the typical audience of the tag without the need for usage guidelines/wikis.
      • Tag length: Growth is inversely proportional to Tag length.
      • Tag concept popularity: How popular is the concept proposed popular among the intended audience?
    • If the tag's growth is mainly inorganic, it'll create unnecessary burdens on the tag editors, annoy other users(because questions are frequently edited(mostly in bulk) to just add the tags as deemed necessary by one editor),actively harm by hiding questions from potential answerers.

    • If added inorganically, how many users are adding the tag? If the tag editing burden is carried by a lot of users with no one user's contribution significantly higher, then the growth may continue despite it's inorganic nature.

I propose that for a tag to be branched, At least 3 of the above 4 criteria be satisfied.

22
  • 1
    I like that approach - answering these questions can be formalized and verified with data, not abstract discussions on usefulness.
    – 0Valt
    Commented Aug 8, 2020 at 14:35
  • 1
    @oguzismail I invited almost all gold badge holders to discussion. Only one showed up. That too he hasn't made a meta post/ answer even when pushed. Highly unlikely that we have unity. And that is just 1 criteria. They have to decide whether the concept is sufficiently different to warrant a branch.
    – TheMaster
    Commented Aug 8, 2020 at 15:05
  • 3
    @oguzismail how are -dashboard, -quota and google-documentation on-topic on SO? I don't think they are. But here we are.
    – TheMaster
    Commented Aug 8, 2020 at 15:06
  • 1
    @oguzismail - two of which currently actively participate in discussions ( btw, TheMaster, congratulations on the badge ). Proportional voting system based on a level of tag badge is a very good way to determine SME.
    – 0Valt
    Commented Aug 8, 2020 at 15:07
  • 2
    @oguzismail That'd be great. But even Oleg doesn't agree with me on that I think. We currently have a plan to go full meta for each tag here. :sigh:
    – TheMaster
    Commented Aug 8, 2020 at 15:11
  • 1
    @TheMaster - yes, unfortunately, there is a couple of tags I disagree... But that is what the discussion is for, after all, and due process - so we do not iterate over and over again. Even if I won't like a decision on some of them, I will be content and happy if we did our best to discuss and voted upon what to do next.
    – 0Valt
    Commented Aug 8, 2020 at 15:14
  • 1
    @oguzismail Exactly. It's pointless. Ruben started all this I think. By full meta, I mean full discussion on for/ against to show consensus.
    – TheMaster
    Commented Aug 8, 2020 at 15:16
  • 1
    @oguzismail - at least we will have a point of reference and potentially a consensus. So far we have several highly active users in the related tags that agreed on follow the rules if they are discussed and voted upon. I am a bit scared to hear about the idea of leaving anyone out of the decision process on a community-driven website.
    – 0Valt
    Commented Aug 8, 2020 at 15:22
  • 1
    @OlegValter I agree. It should be all inclusive and all voices who wants to speak should be heard. My contention is simply that this painful process was not undertaken when someone unilaterally created the tag and retagged.
    – TheMaster
    Commented Aug 8, 2020 at 15:34
  • 2
    @oguzismail That kind of contradicts with This should be voted upon by subject experts/badge holders of the tag No. It doesn't. Subject experts decide whether a concept is sufficiently different. And I agree that badge holders should have more power. I disagree with silencing dissenting opinions. All voices should be heard. But decision should belong to stake holders, who actually visit the tag and answer. Public voices also mean moderators can override any decision made by badge holders.
    – TheMaster
    Commented Aug 8, 2020 at 15:40
  • 1
    Google Apps Script is not a language. The language is JavaScript, and if the developer uses CLASP they could use TypeScript.
    – Wicket
    Commented Aug 8, 2020 at 19:14
  • 1
    Is there a FAQ (or a related canonical Q/A) about "LEGO tags"?
    – Wicket
    Commented Aug 8, 2020 at 19:16
  • 1
    Is there a FAQ (or a related canonical Q/a) about "organical tag growth"?
    – Wicket
    Commented Aug 8, 2020 at 19:18
  • 1
    @OlegValter I mentioned an "if" regarding TS :)
    – Wicket
    Commented Aug 8, 2020 at 23:49
  • 2
    The "organic approach" is certainly more intuitive and will lead to less wrong tagging by new users. An inexperienced user will most likely only tag his question with google-apps-script and might be overwhelmed when he sees 15 different tags including the word google-apps-script, while a more experienced user can refine the branching of his question by adding additional tags - like the above mentioned google-apps-script+arrays. Commented Aug 10, 2020 at 7:44
2

Tag naming convention

Proposed tag naming convention for tags that are about Google Apps Script stuff

google-apps-script-

Whenever it's possible use google-apps-script- for tags that are about Google Apps Script stuff (child tags)

Why? Because searching [google-apps-script*] will show something like this:

gs-

When it's not possible to use google-apps-script, i.e. the tag will not be allowed because its length exceeds the 35 character limit, use gs-

Why? Because searching [gs-*] will show something like this:

gs- might not be very fortunate as it's currently used for Google Sheet conditional formatting, Google Sheets vlookup function and for GS Collections that is a Java framework. It was suggested to use gas- but its is already used and being discussed in Rename [gas] to [gnu-assembler]

Related

20
  • 1
    I just proposed gs as a synonym of google-apps-script --> Please vote stackoverflow.com/tags/google-apps-script/synonyms
    – Wicket
    Commented Jun 27, 2020 at 17:29
  • In context,gs means google-sheets and not apps script. For eg, gs-conditional-formatting means google-sheets-conditional-formatting
    – TheMaster
    Commented Jun 27, 2020 at 17:29
  • 1
    They're closely related, but not interchangeable. For eg, gs-vlookup has no meaning or place in the context of apps script. gas would've been perfect if it was not already taken.
    – TheMaster
    Commented Jun 27, 2020 at 17:35
  • 2
    By the way when gs-vlookup was created the tag name length limit was very short, maybe the same happened with gs-conditional-formatting. I'm wondering if we should ask that them be renamed to google-sheets-*something* so they will be included when searching for [google-sheets*]
    – Wicket
    Commented Jun 27, 2020 at 17:40
  • 2
    That sounds like a nice idea. Still, gas would be perfect. Can't we rename gnu gas to gnu-a or somethings like that? It's got less than 1k questions.
    – TheMaster
    Commented Jun 27, 2020 at 17:44
  • 2
    Well, I think that we should work a bit on the arguments for that and make a new Q and then ask the help of a diamond moderator.
    – Wicket
    Commented Jun 27, 2020 at 17:47
  • 2
    Furthermore, gnugas has no subdivisions or related tags starting with gas-
    – TheMaster
    Commented Jun 27, 2020 at 17:48
  • 1
    To be honest, if all apps script tags (google-apps-script-*)are renamed(gas-*), it'll be much easier for everyone.
    – TheMaster
    Commented Jun 27, 2020 at 17:50
  • 1
    No, we can't just start calling the Gnu Assembler "gnu-a or something like that", since that's not what it is called. The official name is "gas", so that's what folks are going to call it. Questions about the Gnu Assembler are at least equally on-topic for Stack Overflow, if not more so, than questions about Google Apps, so Google Apps can't just take over gas. If anything, we'd ban gas outright to avoid ambiguity. But I'd rather not.
    – Cody Gray Mod
    Commented Jun 29, 2020 at 5:38
  • 4
    @CodyGray I don't think gas is the official name. Wikipedia says it's "The GNU Assembler, commonly known as gas or simply as" . The official page also doesn't explicitly state "gas". It states "as- Gnu-Assembler" and There is a single mention of "gas" , when referring to news files. I'd like to make the case that "gas" is much more known as "google-apps-script" than "gnu-assembler"- "much more" as in more questions tagged to refer to apps script by initial posters. I
    – TheMaster
    Commented Jun 30, 2020 at 13:01
  • 3
    @CodyGray Although it's true that I've never heard of it or used it before running into tag name similarity, The assumption that it is minor/unpopular is based on number of questions in the tag (754 vs 32855-> Apps script at least 43x more popular). In addition, none of the gas-assembler related tags use the keyword gas, while apps script has so many divisions starting with google-apps-script-*. Prima facie, These are my reasons to even attempt to request the switch from gas: assembler to google-apps-script-> for the sake of all of SO community.
    – TheMaster
    Commented Jul 2, 2020 at 8:17
  • 2
    @CodyGray Yes, the tool is commonly known as gas. That's what everyone calls it, including me, who works with it every day. The same can be said for the scripting language too, and I feel this argument is dangerously bordering on argumentum ad ignorantiam. I see no reason that changing gas to gnu-assembler would cause any confusion, it is objectively clearer as a tag and as TheMaster has pointed out, the numbers support the use of google-apps-script related questions far exceeds the frequency in which GNU assembler related questions are asked. Commented Jul 3, 2020 at 7:44
  • 1
    It's argumentum ad ignorantiam on both sides. All these claims are doing is proving that more people use Google Apps than use gas. It doesn't prove the accuracy of the names.
    – Cody Gray Mod
    Commented Jul 3, 2020 at 7:47
  • 2
    Additionally, while an argument can be made for gs to become a synonym for google-apps-script (*gs-* tags can be renamed to google-sheet-* as even google-sheet-conditional-formatting will stay inside the 35 character limit) this will not alleviate the confusion brought about by the gas tag. In addition to the problems I raised with appscript last October, I have unfortunately lost count how many times I have removed gas from erroneously-tagged google-apps-script questions. Commented Jul 3, 2020 at 7:51
  • 1
    A week later (forgot to follow the answer): @CodyGray - can gas be renamed to gnu-assembler as proposed before (you said that is a possibility earlier) and, judgment of solomon-style, gas not to be made a synonym of either - it can be done that way, right? Those who are new can't create tags, and a person established enough to do so will likely check what happened to gas and find out that it is named gnu-assembler. What do you think?
    – 0Valt
    Commented Jul 8, 2020 at 0:15
0

Regarding the suggest edit for the tag wiki of

I disagree with

Do not use for questions:

  1. seeking debugging help, use appropriate language tag instead

because sometimes the debugging is done by using the Apps Script editor and some of those questions are derived from how the Editor debugging features works.


Nowadays it's possible to use different IDES to work with Google Apps Script thanks to /

I think that should be used for questions that are about using the Google Apps Script editor, including but not limited to:

  1. Creating, editing and deleting *.gs and *.html files
  2. Editing the manifest (appscript.json)
    • Custom oAuth scopes
  3. Disabling/enabling the new runtime (Chrome V8)
  4. Running code from the editor
  5. Debugging code from the editor, including
    • Using Logger
    • Using the Execution Transcript
  6. Enabling/disabling advanced services
  7. Adding and managing libraries
  8. Managing deployments (publishing a new version, etc) of
    • Editor add-ons
    • G Suite / Gmail add-ons
    • Web Applications
  9. ...

Questions that should not include are questions about, but not limited to:

  1. managing (creating, editing, running, deleting, debugging) Google Apps Script projects using CLASP, instead use

  2. using Google Apps Script Dashboard (https://script.google.com), instead use

  3. using Stackdriver, instead use

  4. ...


Questions that are a good fit for this tag

Questions that currently has this tag but it should be removed


This tag could be used together with

  • as this is a broader (and older) tag
  • when the question is about the new Google Apps Script runtime
  • when the question is about the old Google Apps Script runtime
  • for questions about applying a debugging technique in the Google Apps Script editor
  • for questions about using the Google Apps Escript editor for managing Google Apps Script libraries but not for using JavaScript libraries like .
6
  • Rubén, as I mentioned in the comment to the question, I agree with you on that one and already made edits to the proposal, please do check the new revision - should be now better-worded + has a direct reference to debugger guide
    – 0Valt
    Commented Jun 17, 2020 at 20:00
  • 1
    Re: chat room
    – 0Valt
    Commented Jun 17, 2020 at 20:19
  • Btw, Rubén, is the edit for the editor tag still pending (unfortunately I can't see reviews yet, only the status?)
    – 0Valt
    Commented Jun 26, 2020 at 20:52
  • @OlegValter The tag wiki is still waiting to be approved.
    – Wicket
    Commented Jun 26, 2020 at 20:59
  • I see - maybe worth adding to the list in the question to help visibility?
    – 0Valt
    Commented Jun 26, 2020 at 21:08
  • 1
    I'm not sure how effective that will be but I think that more effective to make a new post but that it's not a priority for me right now.
    – Wicket
    Commented Jun 26, 2020 at 21:46
0

Apps Script libraries

is now a synonym of

A subproject of this effort regards the improvement of references to well-known dependencies. It would be a good idea to form a list of libraries to help users with one of the more difficult tasks in Google Apps Script - managing project dependencies (due to lack of module system).

A good example of a well-known library is Eric's OAuth 2.0 library, which is officially recommended. All libraries mentioned must be deployed as an Apps Script Library, should follow guidelines and best practices of the official guide where applicable. The library also should have significant usage and you should be prepared to show that this is the case.

For easy reference: library database thread on Google Apps Script Community.


Embedded preview of GAS libraries open database:

const createIframe = ({ parent = document.body, src } = {}) => {
  const iframe = document.createElement("iframe");
  iframe.width = "100%";
  iframe.height = "300px";
  iframe.src = src;
  
  parent.append(iframe);
  
  return iframe;
};


(() => {

  createIframe({
    src : "https://docs.google.com/spreadsheets/d/e/2PACX-1vS4gVVYZ0L566MiS0_uXu3pQeeRzF__aIQO8l9iuIjq_j8DmyibSwjEo1hkJCyTkkiFcYCWrQnjfsPW/pubhtml?gid=0&single=true&widget=true&headers=false"
  });

})();


You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .