[ 
https://issues.apache.org/jira/browse/HADOOP-18304?focusedWorklogId=783295&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-783295
 ]

ASF GitHub Bot logged work on HADOOP-18304:
-------------------------------------------

                Author: ASF GitHub Bot
            Created on: 21/Jun/22 09:45
            Start Date: 21/Jun/22 09:45
    Worklog Time Spent: 10m 
      Work Description: dannycjones commented on PR #4478:
URL: https://github.com/apache/hadoop/pull/4478#issuecomment-1161515758

   Note that with the current patch, the table of contents has changed.
   
   FROM (trunk):
   
   ```markdown
   # Committing work to S3 with the "S3A Committers"
   ### January 2021 Update
   ## Introduction: The Commit Problem
   ### Background : Hadoop's "Commit Protocol"
   ## Meet the S3A Committers
   ### The Staging Committer
   ## Conflict Resolution in the Staging Committers
   ### The Magic Committer
   #### Which Committer to Use?
   ## Switching to an S3A Committer
   ## Using the Directory and Partitioned Staging Committers
   ## The "Partitioned" Staging Committer
   ### Notes
   ## Using the Magic committer
   ### FileSystem client setup
   ### Enabling the committer
   ## Common Committer Options
   ## Staging committer (Directory and Partitioned) options
   ### Common Committer Options
   ### Staging Committer Options
   ### Disabling magic committer path rewriting
   ## <a name="concurrent-jobs"></a> Concurrent Jobs writing to the same 
destination
   ## Troubleshooting
   ```
   
   TO (HEAD):
   
   ```markdown
   # Committing work to S3 with the "S3A Committers"
   ### January 2021 Update
   ## Introduction: The Commit Problem
   ### Background: Hadoop's "Commit Protocol"
   ## Meet the S3A Committers
   ### The Staging Committers
   #### Conflict Resolution in the Staging Committers
   ### The Magic Committer
   ### Which Committer to Use?
   ## Switching to an S3A Committer
   ## Using the Staging Committers
   ### The "Partitioned" Staging Committer
   ### Notes on using Staging Committers
   ## Using the Magic committer
   ### FileSystem client setup
   ### Enabling the committer
   ## Committer Options Reference
   ### Common S3A Committer Options
   ### Staging committer (Directory and Partitioned) options
   ### Disabling magic committer path rewriting
   ## <a name="concurrent-jobs"></a> Concurrent Jobs writing to the same 
destination
   ## Troubleshooting
   ```
   
   
   
   




Issue Time Tracking
-------------------

    Worklog Id:     (was: 783295)
    Time Spent: 20m  (was: 10m)

> Improve S3A committers documentation clarity
> --------------------------------------------
>
>                 Key: HADOOP-18304
>                 URL: https://issues.apache.org/jira/browse/HADOOP-18304
>             Project: Hadoop Common
>          Issue Type: Sub-task
>          Components: documentation
>            Reporter: Daniel Carl Jones
>            Assignee: Daniel Carl Jones
>            Priority: Trivial
>              Labels: pull-request-available
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> I recently was learning more about the S3A committers. I'm hoping to provide 
> some improvements as someone who has recently read [this 
> documentation|https://github.com/apache/hadoop/blob/1f157f802d2d6142d21482eaa86baf1bef458ed4/hadoop-tools/hadoop-aws/src/site/markdown/tools/hadoop-aws/committers.md#L495]
>  without fully understanding prior.
> For instance, referencing different components more explicitly and adding 
> pre-requisite info.



--
This message was sent by Atlassian Jira
(v8.20.7#820007)

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to