[
https://issues.apache.org/jira/browse/HIVE-28666?focusedWorklogId=948032&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-948032
]
ASF GitHub Bot logged work on HIVE-28666:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 12/Dec/24 14:45
Start Date: 12/Dec/24 14:45
Worklog Time Spent: 10m
Work Description: okumin commented on code in PR #21:
URL: https://github.com/apache/hive-site/pull/21#discussion_r1882285275
##########
config.toml:
##########
@@ -28,8 +28,8 @@ theme = 'hive'
[params.navbar]
release = "/general/downloads"
javaDocs = "/docs/javadocs/"
+ latest = "/docs/latest/"
languageManual =
"https://cwiki.apache.org/confluence/display/Hive/LanguageManual";
- wiki = "https://cwiki.apache.org/confluence/display/Hive/";
Review Comment:
I wonder if we should keep WIKI for a while or we should move to hive-site
immediately.
Issue Time Tracking
-------------------
Worklog Id: (was: 948032)
Time Spent: 20m (was: 10m)
> Migrate documentation from the wiki to the website
> --------------------------------------------------
>
> Key: HIVE-28666
> URL: https://issues.apache.org/jira/browse/HIVE-28666
> Project: Hive
> Issue Type: Task
> Security Level: Public(Viewable by anyone)
> Components: Website
> Reporter: Stamatis Zampetakis
> Assignee: Stamatis Zampetakis
> Priority: Major
> Labels: pull-request-available
> Attachments: html_to_markdown.py
>
> Time Spent: 20m
> Remaining Estimate: 0h
>
> Currently all documentation is hosted and maintained in the Confluence wiki
> (https://cwiki.apache.org/confluence/display/Hive/Home). The wiki has certain
> drawbacks that are not easy to circumvent.
> 1. Contributions are cumbersome. New contributors have to request a wiki
> account from INFRA and then the PMC must give additional karma to the user to
> be able to modify the space.
> 2. Reviews are difficult. There is no built-in feature in Confluence that
> allows to review changes before updating the content of the space.
> 3. History is hard to track. Although, versioning is supported at page level
> finding who and when modified a part of the page is not straightforward.
> Moreover, when pages get moved, deleted, etc., it's very hard or impossible
> to track what happened.
> 4. Limited access control. Any user with the basic permissions that are
> usually given on-demand can modify any part of the space without anyone
> realizing.
> The above shortcomings can be alleviated by putting the documentation under
> the Website (https://hive.apache.org/) that is under version control (git).
> Shortcomings of confluence have appeared various times in discussions in the
> dev list:
> * https://lists.apache.org/thread/58zhfdklq485c6942fj0lmpzmh8o9fch
> * https://lists.apache.org/thread/jcck8tdod3hyzf5wjzxzn075xn79st4h
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
