5

Recently How to solve common errors in Google Apps Script development was posted and had several upvotes, but it was also closed.

NOTE: This is not a duplicate of What to do about hundreds of the same basic question? because this about an specific question which discussion through comments is becoming lengthy

The question has several problems.

  1. It's not a question
  2. It's too broad (it's about "common error"s, not about a specific error)
  3. It's primarily opinion-based (while there is a list of "examples" there aren’t explicit criteria to qualify which errors are common, i.e., the minimum pages that searching an error should be returned)
  4. It's a "listing" question type
  5. The conversation in the comments is lengthy (the question was posted June 12th, 2020, and it had 18 comments the next day, at the time that this post was created, as Oct 7th, 2022 it has +20 comments still shown)
  6. It's not a good "original" to close as duplicate good questions as each answer is about a different error that might not have common causes / solutions.

Regarding the answers (so far it has 2)

  1. They are a list of errors. While they are using headings, because their length and the SO lack of inner-links (i.e., TOC linking to each header) it's "hard" to jump directly to the section of interest (if you have the error text using the web browser "find" command will do the job).

As of Oct 2022, the question is open. So what should we do to keep the question open as there are similar questions for other languages (they are mentioned in the question)?

Preface

This Q&A strives to become a collection and a reference target for common errors encountered during development in Google Apps Script language in hopes to improve long-term maintainability of tag.

There are several similar and successful undergoings in other languages and general-purpose tags (see c++, android, php, php again), and this one follows suit.


Why it exists?

The amount of questions from both new and experienced developers regarding the meaning and solutions to errors encountered during development and production that can be effectively reduced to a single answer is substantial. At the time of writing, even running a query only by language tag yields:

Linking to a most relevant duplicate is hard and time-consuming for volunteers due to the need to consider nuances and often poorly-worded titles.


What it consists of?

Entries in this Q&A contain are designed as to provide info on how to:

  • parse the error message structure
  • understand what the error entails
  • consistently reproduce (where applicable)
  • resolve the issue
  • provide a link to canonical Q&A (where possible)

What this is not?

The scope of the Q&A is limited to common (not trivial). This is not:

  • a catch-all guide or "best practices" collection
  • a reference for general ECMAScript errors
  • GAS documentation
  • a resources list (we have a tag wiki for that)

What to add?

When adding an entry, please, consider the following:

  • is the error common enough (see "why" section for examples)?
  • can the solution be described concisely and be applicable for most cases?

! The initial answer is a community wiki already and the question is intended to become one as well as soon as the status of the Q&A itself is resolved. You are most welcome and encouraged to contribute

Related

11
  • 1
    Thank you for moving the discussion to meta, Rubén! I will provide some extra context for the discussion regarding reasoning and possible steps that should be taken that will benefit the community - looking forward to community feedback and suggestions on what would be the most beneficial way to proceed. Commented Jun 13, 2020 at 15:47
  • It is a canonical question and answer and so i voted to open it again, so that other can helpo with their answers
    – nbk
    Commented Jun 13, 2020 at 16:39
  • 1
    @nbk I think that it should not be reopened while we are discussing it here.
    – Wicket
    Commented Jun 13, 2020 at 16:45
  • 1
    Thanks, @nbk - though, I must point out that I don't see a problem in it being closed and still be helpful (even I can't argue well against collection of questions being, well, a bit too broad :) - I and others can still improve answers, and after a decision is reached, we will have all the building blocks at hand. What I would do, though, on reopen, is at least split general and service-specific entries into separate answers while we disccuss. Commented Jun 13, 2020 at 16:48
  • i was not the first and hopefully also not the last to vote to reopen. It.is a braid question,without a doubt, but with that answer it is helpful and concetrated
    – nbk
    Commented Jun 13, 2020 at 16:48
  • Btw, just to have a clear policy: can this Q&A currently used as a dupe target in case a canonical / detailed answer cannot be found or would it be better to wait until we reach a consensus? I am a bit torn on the matter and a community input is highly appreciated! Commented Jun 13, 2020 at 18:19
  • 2
    @OlegValter No. Dup questions should be questions and answer meet the quality guidelines : 1) How to Ask, 2) How to Answer, by the other hand we should not deliberately make changes that should be changed later.
    – Wicket
    Commented Jun 13, 2020 at 18:21
  • 1
    Thanks, duly noted! Will retract a couple of older flags (phew, only one) while I am at it Commented Jun 13, 2020 at 18:23
  • 1
    @OlegValter also, the answer should be contained within it. It would be counterproductive to close a duplicate and that the next reader that may already have the information diagnosing the issue is redirected towards how to obtain debugging information.
    – Braiam
    Commented Jun 13, 2020 at 18:30
  • (Something seems to be missing near "So what we keep the question as there") Commented Oct 7, 2022 at 16:44
  • @PeterMortensen Thanks. I added some slight updates. I not remember what was in my mind about that specific statement ... I think that I was asking for suggestions to keep the question open... Nowadays it's open.
    – Wicket
    Commented Oct 7, 2022 at 19:11

4 Answers 4

11

I really have a thing for how to debug X style questions, but X has to be defined to a simple single message, specially if said message can mean several things depending the context. Rather than having one question for several messages, is better to have several questions for each message instead. That way, readers would only find information relevant to the issue they are having.

2
  • 1
    Hi @Braiam - thank you for feedback - we have actually been discussing this option (I am the OP and currently drafting up an answer with info in that regard). I agree that having multiple questions each targeting a specific error / error group looks like a better alternative. Before the question got closed, I was considering splitting it into multiple answers on a single question, but the idea of a decentralized approach resonates well with me Commented Jun 13, 2020 at 16:08
  • Welcome back!!!
    – TheMaster
    Commented Oct 7, 2022 at 16:49
4

Regarding

in Google Apps Script language in hopes to improve long-term maintainability of tag.

don't forget the tag wiki. We could add to it a list of canonical questions as it was done on the tag wiki of (and maybe other tags)

Many of the "more specific" tags were synonymized / removed in favor of "combo tagging" (using two or more tags instead of one)
Also don't forget that we could use more specific tags for canonical questions for errors which context is relevant, i.e.

among others

Related

0
3

As the OP of the discussed post, I have to add that there is a proposal (which I fully support) to split the post into multiple Q&As that specifically target each question separately and make them community wikis as well as update the corresponding language tag wiki in a similar way to how it is done by JavaScript wiki.

The idea for the post came as a result of a prolonged observation of a stream of questions and answers (I am guilty as charged of the latter as much as others) that explain a more or less fixed set of frequent errors in the context of a question, usually dealing with what has to be done instead of why they happen in the first place (and given the questions, I totally understand why).

I agree with all points made by Rubén and would like to provide additional context for some of them:

It's primarily opinion-based

I agree that the definition of common is lax (at least in a way that I presented it in the question). When creating the Q&A, I considered the question common if it had:

  1. more than a page of questions that all effectively ask to explain what the error message means or why it happens.
  2. one or at least a closed list of root causes and therefore could be answered in a generalized form without any loss of meaning.

It's a "listing" question type

Before posting, the extended discussion regarding "listing" (or "reference") Q&As was taken into consideration, and the reason why I decided to proceed was that similar projects with an exception of [tag:php] list were concentrating on creating a hub of links to other questions and not on providing tailored answers (with links to canonicals upon discovery).


To highlight what the primary consideration for going forward with this Q&A is as of now:

  1. Continue adding value to the current answer
  2. Linking canonical Q&As if such exist
  3. If a positive decision is reached, split the Q&A into multiple community wikis that follow the same structure which I envision as follows:
    • common error message (with truncated variable part) as title, something like "How to fix [error message here]" to make them more discoverable
    • concise description of the meaning of the error
    • steps to reproduce the issue in general
    • guides on how to fix the issue and code samples where applicable
    • references to related Q&As dealing with edge cases or otherwise potentially of interest
  4. Post answers in / update existing canonical Q&As (if any)
  5. Edit tag info wiki Q&A-style linking them while avoiding creation of "list"-type question.
3

is now a synonym of . The combo [google-apps-script][custom-function] (very likely that most of the questions having this combo are about Google Sheets custom functions) currently has 787 results / 332 questions https://stackoverflow.com/search?q=%5Bcustom-function%5D


I think that one of the projects that could be derived from this question is a retagging project for questions about Google Sheets custom functions

So far I just created and proposed the tag excerpt and wiki.

In the context of this discussion I suggest to look for questions about Google Sheets custom functions that claims that an error occurred but that is cause to the Google Sheets custom functions limitations like

  1. The execution time exceed the 30 seconds limit
  2. Use a method that requires an authorization scope

To find these questions you could start searching for candidates by using

Remember, while you are editing a question fix other problems or improve the question to make it clear, specific, etc.

Related

4
  • 1
    Note for others: there is a generic custom-function which is "a bit" of a mess (besides, it does not have a wiki). Since we now have a dedicated tag, I would suggest at least swapping them (especially considering the amount of specific restrictions imposed on such functions I fully support the idea) Commented Jun 13, 2020 at 17:14
  • 1
    @OlegValter I just posted Canonical question for "You do not have permission" in Google Sheets custom functions
    – Wicket
    Commented Jun 14, 2020 at 17:14
  • 787? [custom-function] alone only contains 474 questions.
    – TheMaster
    Commented Oct 7, 2022 at 16:01
  • 1
    @TheMaster 787 results -> meaning questions & answers. Adding is:question to the referred search returns 332 results
    – Wicket
    Commented Oct 7, 2022 at 21:12

You must log in to answer this question.

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