Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CLDR-17566 Converting development process to markdown #3712

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

chpy04
Copy link

@chpy04 chpy04 commented May 11, 2024

CLDR-17566

Part of the CLDR --> GFM conversion project

View text diffs here

ALLOW_MANY_COMMITS=true


3. If user does not select the Component, it remains for the group TC triage with Component=to-assess, Owner=anybody. These tickets will be assessed after all the pre-assessed tickets have been triaged.

2. All TC members, look at [To-assess by Owner / Component](https://www.google.com/url?q=https%3A%2F%2Funicode.org%2Fcldr%2Ftrac%2Freport%2F100&sa=D&sntz=1&usg=AOvVaw3RRcS9UWwOlotoRAFsV3fJ) before each triage day.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You need to resolve links that start with https://www.google.com/url?q= first.

Easiest way is to paste into a browser's address bar; the browser will resolve it — in this case, to:

https://cldr.unicode.org/index/bug-reports#TOC-Filing-a-Ticket

### Filing tickets

1. You can add set other fields, but don't change the Owner. That way the committee sees the incoming tickets (those marked as Owner: somebody).

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are extra blank lines between list items; these should be removed.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, in the Summary, add a link to the comparison between the old (in plaintext) and the new (in plaintext).

@macchiati macchiati requested review from srl295 and btangmu May 13, 2024 00:34
@macchiati
Copy link
Member

Adding @btangmu and @SRL for any comments they have

@srl295 srl295 self-assigned this May 13, 2024

1. The future folder tickets are moved to the discuss folder

2. Unscheduled tickets (with no release number) are re-evaluated.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. Unscheduled tickets (with no release number) are re-evaluated.
2. Unscheduled tickets (with no release number) are re-evaluated.

wrong indentation for list


1. All reviewers should be done well before the end of the release, so that any problems can be taken care of.

2. At release time, all the tickets with status "fixed" are changed to "closed".
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
2. At release time, all the tickets with status "fixed" are changed to "closed".
2. At release time, all the tickets with status "fixed" are changed to "closed".

check indentation so it lines up


### Survey Tool in Production Phase!

1. **Before** you make a commit, add a line to the Issues spreadsheet below ([Spreadsheet View](https://docs.google.com/spreadsheet/ccc?key=0AqRLrRqNEKv-dF9DdVRPVmhHdzhheDliOEpLSUhObXc#gid=3)), with status OPEN, bug number, short desc.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@macchiati Higher level comment: this is actually an obsolete process.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right. We just want to get the source into markdown before fixing.


1. Assignees periodically review and take care of their tickets.

1. Go to [http://unicode.org/cldr/trac/report/61](http://www.google.com/url?q=http%3A%2F%2Funicode.org%2Fcldr%2Ftrac%2Freport%2F61&sa=D&sntz=1&usg=AOvVaw0UYmG2ygYOMySNUAGnbPKu) for **My Tickets**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

obsolete link

1. All commits must have as their first line: "CLDR-XXX <description>", where XXX is the ticket number.


2. **Don't mark the bug as fixed! Instead,**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

list indentation issue here


### DTD Changes

* **If you are making any DTD changes, please follow the instructions on** [**Updating DTDs**](/development/updating-dtds)**.**
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* **If you are making any DTD changes, please follow the instructions on** [**Updating DTDs**](/development/updating-dtds)**.**
* **If you are making any DTD changes, please follow the instructions on** [**Updating DTDs**](https://cldr.unicode.org/development/updating-dtds)**.**

site-relative link (and there are others) but perhaps it's better to just make them absolute to start and then we can fix up en masse later?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, good idea.

@srl295
Copy link
Member

srl295 commented May 13, 2024

The conversion is generally good but a lot of the content is out of date. Getting it moved over, though is a good step towards improvement.

Comment on lines +1 to +3
---
title: Handling Tickets (bugs/enhancements)
---
Copy link
Member

@srl295 srl295 May 13, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a note: If this shows up in the output (I don't think it will) I can fix the conversion process. Don't remove it if you happen to see this show up oddly in the output.

@macchiati
Copy link
Member

macchiati commented May 13, 2024 via email

@chpy04
Copy link
Author

chpy04 commented May 22, 2024

I believe this resolves the changes you guys were talking about. @macchiati, I am a bit confused as to what I should put for the diffs between the plain texts. I tried your suggestion with Google Docs history but it doesn't ignore whitespace so I couldn't get it to work and was just using a browser tool. Let me know what I should link to.

@macchiati
Copy link
Member

macchiati commented May 22, 2024 via email

@chpy04
Copy link
Author

chpy04 commented May 22, 2024

I looked into it some more and it seems like the history on google docs just looks at what the user did not the differences, so even if you copy in the same text the history looks like deleting and re-entering. Another option would be to include a screenshot of my diff tool in the comment. This might not be as convincing as a PR but would be faster.

@macchiati
Copy link
Member

macchiati commented May 23, 2024 via email

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants