You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@spark.apache.org by "Hyukjin Kwon (JIRA)" <ji...@apache.org> on 2019/05/21 04:04:38 UTC

[jira] [Updated] (SPARK-19551) Theme for PySpark documenation could do with improving

     [ https://issues.apache.org/jira/browse/SPARK-19551?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Hyukjin Kwon updated SPARK-19551:
---------------------------------
    Labels: bulk-closed  (was: )

> Theme for PySpark documenation could do with improving
> ------------------------------------------------------
>
>                 Key: SPARK-19551
>                 URL: https://issues.apache.org/jira/browse/SPARK-19551
>             Project: Spark
>          Issue Type: Documentation
>          Components: Documentation, PySpark
>    Affects Versions: 2.1.0
>            Reporter: Arthur Tacca
>            Priority: Minor
>              Labels: bulk-closed
>
> I have found the Python Spark documentation hard to navigate for two reasons:
> * Each page in the documentation is huge, because the whole of the documentation is split up into only a few chunks.
> * The methods for each class is not listed in a short form, so the only way to look through them is to browse past the full documentation for all methods (including parameter lists, examples, etc.).
> This has irritated someone enough that they have done [their own build of the pyspark documentation|http://takwatanabe.me/pyspark/index.html]. In comparison to the official docs they are a delight to use. But of course it is not clear whether they'll be kept up to date, which is why I'm asking here that the official docs are improved. Perhaps that site could be used as inspiration? I don't know much about these things, but it appears that the main change they have made is to switch to the "read the docs" theme.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@spark.apache.org
For additional commands, e-mail: issues-help@spark.apache.org