[ https://issues.apache.org/jira/browse/SPARK-18073?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]
Sean Owen updated SPARK-18073: ------------------------------ Description: Per http://apache-spark-developers-list.1001551.n3.nabble.com/Mini-Proposal-Make-it-easier-to-contribute-to-the-contributing-to-Spark-Guide-td19493.html , let's consider migrating all wiki pages to documents at github.com/apache/spark-website (i.e. spark.apache.org). Some reasons: * No pull request system or history for changes to the wiki * Separate, not-so-clear system for granting write access to wiki * Wiki doesn't change much * One less place to maintain or look for docs The idea would be to then update all wiki pages with a message pointing to the new home of the information (or message saying it's obsolete). Here are the current wikis and my general proposal for what to do with the content: * Additional Language Bindings -> roll this into Third Party Projects * Committers -> Migrate to a new /committers.html page; wiki already linked under Communitiy menu * Contributing to Spark -> a new /contributing.html page under Community menu ** Jira Permissions Scheme -> obsolete ** Spark Code Style Guide -> roll this into new contributing.html page * Development Discussions -> obsolete * Powered By Spark -> new /powered-by.html linked by the existing Communnity menu item * Preparing Spark Releases -> see below; roll into "versioning policy" * Profiling Spark Applications -> roll into Useful Developer Tools ** Profiling Spark Applications Using YourKit -> roll into Useful Developer Tools * Spark Internals -> new page under Developer menu ** Java API Internals ** PySpark Internals ** Shuffle Internals ** Spark SQL Internals ** Web UI Internals * Spark QA Infrastructure -> new element in new Developer menu * Spark Versioning Policy -> new page living under Developer menu ** spark-ec2 AMI list and install file version mappings -> obsolete ** Spark-Shark version mapping -> obsolete * Third Party Projects -> new page; already linked as Community menu item * Useful Developer Tools -> new page under new Developer menu ** Jenkins -> obsolete, remove Of course, another outcome is to just remove outdated wikis, migrate some, leave the rest. Thoughts? was: Per http://apache-spark-developers-list.1001551.n3.nabble.com/Mini-Proposal-Make-it-easier-to-contribute-to-the-contributing-to-Spark-Guide-td19493.html , let's consider migrating all wiki pages to documents at github.com/apache/spark-website (i.e. spark.apache.org). Some reasons: * No pull request system or history for changes to the wiki * Separate, not-so-clear system for granting write access to wiki * Wiki doesn't change much * One less place to maintain or look for docs The idea would be to then update all wiki pages with a message pointing to the new home of the information (or message saying it's obsolete). Here are the current wikis and my general proposal for what to do with the content: * Additional Language Bindings -> roll this into wherever Third Party Projects ends up * Committers -> Migrate to a new /committers.html page, linked under Community menu (alread exists) * Contributing to Spark -> Make this CONTRIBUTING.md? or a new /contributing.html page under Community menu ** Jira Permissions Scheme -> obsolete ** Spark Code Style Guide -> roll this into new contributing.html page * Development Discussions -> obsolete? * Powered By Spark -> Make into new /powered-by.html linked by the existing Commnunity menu item * Preparing Spark Releases -> see below; roll into where "versioning policy" goes? * Profiling Spark Applications -> roll into where Useful Developer Tools goes ** Profiling Spark Applications Using YourKit -> ditto * Spark Internals -> all of these look somewhat to very stale; remove? ** Java API Internals ** PySpark Internals ** Shuffle Internals ** Spark SQL Internals ** Web UI Internals * Spark QA Infrastructure -> tough one. Good info to document; does it belong on the website? we can just migrate it * Spark Versioning Policy -> new page living under Community (?) that documents release policy and process (better menu?) ** spark-ec2 AMI list and install file version mappings -> obsolete ** Spark-Shark version mapping -> obsolete * Third Party Projects -> new Community menu item * Useful Developer Tools -> new page under new Developer menu? Community? ** Jenkins -> obsolete, remove Of course, another outcome is to just remove outdated wikis, migrate some, leave the rest. Thoughts? > Migrate wiki to spark.apache.org web site > ----------------------------------------- > > Key: SPARK-18073 > URL: https://issues.apache.org/jira/browse/SPARK-18073 > Project: Spark > Issue Type: Improvement > Components: Documentation > Affects Versions: 2.0.1 > Reporter: Sean Owen > Assignee: Sean Owen > Priority: Critical > > Per > http://apache-spark-developers-list.1001551.n3.nabble.com/Mini-Proposal-Make-it-easier-to-contribute-to-the-contributing-to-Spark-Guide-td19493.html > , let's consider migrating all wiki pages to documents at > github.com/apache/spark-website (i.e. spark.apache.org). > Some reasons: > * No pull request system or history for changes to the wiki > * Separate, not-so-clear system for granting write access to wiki > * Wiki doesn't change much > * One less place to maintain or look for docs > The idea would be to then update all wiki pages with a message pointing to > the new home of the information (or message saying it's obsolete). > Here are the current wikis and my general proposal for what to do with the > content: > * Additional Language Bindings -> roll this into Third Party Projects > * Committers -> Migrate to a new /committers.html page; wiki already linked > under Communitiy menu > * Contributing to Spark -> a new /contributing.html page under Community menu > ** Jira Permissions Scheme -> obsolete > ** Spark Code Style Guide -> roll this into new contributing.html page > * Development Discussions -> obsolete > * Powered By Spark -> new /powered-by.html linked by the existing Communnity > menu item > * Preparing Spark Releases -> see below; roll into "versioning policy" > * Profiling Spark Applications -> roll into Useful Developer Tools > ** Profiling Spark Applications Using YourKit -> roll into Useful Developer > Tools > * Spark Internals -> new page under Developer menu > ** Java API Internals > ** PySpark Internals > ** Shuffle Internals > ** Spark SQL Internals > ** Web UI Internals > * Spark QA Infrastructure -> new element in new Developer menu > * Spark Versioning Policy -> new page living under Developer menu > ** spark-ec2 AMI list and install file version mappings -> obsolete > ** Spark-Shark version mapping -> obsolete > * Third Party Projects -> new page; already linked as Community menu item > * Useful Developer Tools -> new page under new Developer menu > ** Jenkins -> obsolete, remove > Of course, another outcome is to just remove outdated wikis, migrate some, > leave the rest. > Thoughts? -- This message was sent by Atlassian JIRA (v6.3.4#6332) --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@spark.apache.org For additional commands, e-mail: issues-h...@spark.apache.org