[GitHub] [incubator-superset] metaperl opened a new issue #8834: Regularize and clarify the security documentation?

[GitBox <gi...@apache.org>]

metaperl opened a new issue #8834: Regularize and clarify the security documentation?
URL: https://github.com/apache/incubator-superset/issues/8834
 
 
   Hello, I've been trying to read [the Superset security docs](https://superset.incubator.apache.org/security.html). In doing so, I have noticed certain things and had certain questions/suggestions:
   
   # Tabulate the abilities of each built-in role
   
   When reading the informal description of the built-in roles, I felt a need to tabulate and categorize the various functionalities. I'm aware that a comprehensive tabulation would include all 5 rights `(can_edit, can_show, can_delete, can_list, can_add)`, but I think something like this would help people have a definite idea of what is available to which role:
   
   https://docs.google.com/spreadsheets/d/1ZHyPLmNCj8OceCFCSN7Qrd-tbj1pNcJE9hzjRtokIx8/edit?usp=sharing
   
   Continuing through the docs, I see the phrase:
   
   > Alpha users have access to all data sources
   
   and my question is:
   
   # What is a "data source"? Please define it.
   
   How many ways can they be created? Is there a Venn diagram that clearly depicts the relationship of datasources to schemas, databases and their tables and the various operations of Superset?
   
   The user interace has a "Sources" menu item, which leads one to believe that databases and tables are the only things that are data sources, but this cannot be. Because we know that [data sources can be created via the Visualize button](https://github.com/apache/incubator-superset/issues/2798).
   
   So again, it would be nice to know what constitutes a data source.
   
   Under [Managing Gamma per data source access
   ](https://superset.incubator.apache.org/security.html#managing-gamma-per-data-source-access) we read
   
   > Here’s how to provide users access to only specific datasets.
   
   And the question is:
   
   # "what is a **dataset** and does it differ from a **data source**? 
   
   If the two are the same, then why not use a single, canonical, well-defined term instead of introducing confusion by the use of undefined synonyms-by-inference?
   
   
   
   
   

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@superset.apache.org
For additional commands, e-mail: notifications-help@superset.apache.org