[
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:
* (Main wiki page) -> roll into "versioning policy" (below) as all it really
has is release cadence info
* 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 -> long since obsolete; delete it
** Spark Code Style Guide -> roll this into new /contributing.html page
* Development Discussions -> looks obsolete and didn't really get underway;
delete it
* 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 -> leave in place and don't port, but note that it's no
longer up to date
** Java API Internals
** PySpark Internals
** Shuffle Internals
** Spark SQL Internals
** Web UI Internals
* Spark QA Infrastructure -> leave in place and don't port, but note that it's
no longer up to date
* Spark Versioning Policy -> Combine into new /release-process.html under
Developer
** spark-ec2 AMI list and install file version mappings -> leave in place and
don't port, but note that it's no longer up to date
** Spark-Shark version mapping -> leave in place and don't port, but note that
it's no longer up to date
* Third Party Projects -> new page; already linked as Community menu item
* Useful Developer Tools -> new page under new Developer menu
** Jenkins -> leave in place and don't port, but note that it's no longer up to
date
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:
* (Main wiki page) -> roll into "versioning policy" (below) as all it really
has is release cadence info
* 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 -> obsolete, remove; not that relevant to project
dev/user and not updated in a long time
* Spark Versioning Policy -> Combine into new /release-process.html under
Developer
** 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?
> 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:
> * (Main wiki page) -> roll into "versioning policy" (below) as all it really
> has is release cadence info
> * 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 -> long since obsolete; delete it
> ** Spark Code Style Guide -> roll this into new /contributing.html page
> * Development Discussions -> looks obsolete and didn't really get underway;
> delete it
> * 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 -> leave in place and don't port, but note that it's no
> longer up to date
> ** Java API Internals
> ** PySpark Internals
> ** Shuffle Internals
> ** Spark SQL Internals
> ** Web UI Internals
> * Spark QA Infrastructure -> leave in place and don't port, but note that
> it's no longer up to date
> * Spark Versioning Policy -> Combine into new /release-process.html under
> Developer
> ** spark-ec2 AMI list and install file version mappings -> leave in place and
> don't port, but note that it's no longer up to date
> ** Spark-Shark version mapping -> leave in place and don't port, but note
> that it's no longer up to date
> * Third Party Projects -> new page; already linked as Community menu item
> * Useful Developer Tools -> new page under new Developer menu
> ** Jenkins -> leave in place and don't port, but note that it's no longer up
> to date
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
