[
https://issues.apache.org/jira/browse/HIVE-28666?focusedWorklogId=948050&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-948050
]
ASF GitHub Bot logged work on HIVE-28666:
-----------------------------------------
Author: ASF GitHub Bot
Created on: 12/Dec/24 15:44
Start Date: 12/Dec/24 15:44
Worklog Time Spent: 10m
Work Description: simhadri-g commented on PR #21:
URL: https://github.com/apache/hive-site/pull/21#issuecomment-2539324991
I have deployed it with github pages here:
https://simhadri-g.github.io/hive-site/docs/latest/
This is really great start, we can incrementally improve the docs from here
:)
Issue Time Tracking
-------------------
Worklog Id: (was: 948050)
Time Spent: 40m (was: 0.5h)
> 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: 40m
> 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)
