Github user liancheng commented on the issue:

    https://github.com/apache/spark/pull/13972
  
    @yinxusen Thanks for the review! Also discussed with @mengxr. IIUC, 
overlapped labels is most useful for handling imports, since sometimes we may 
want to include one import line in multiple example snippet blocks. Regarding 
to this issue, I have two concerns:
    
    1. It's a rare case, and we possibly can workaround this case while 
authoring documentations. Thus I guess we can do it in a follow-up PR.
    2. Instead of overlapped labels, I'd prefer a multi-label approach:
    
       ```scala
       // $example on:A$
       import org.examples.A
       // $example off:A$
       // $example on:A:B$
       import org.examples.common._
       // $example off:A:B$
       // $example on:B$
       import org.examples.B
       // $example off:B$
       ```
    
       This approach achieves the same goal, and is much simpler to implement 
than handling overlapped scoping.



---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to