New issue
Advanced search Search tips

Issue 676670 link

Starred by 1 user
Status: Archived
Owner: ----
Closed: Aug 2017
Components:
EstimatedDays: ----
NextAction: ----
OS: ----
Pri: 3
Type: Task



Sign in to add a comment

Make Blink tools and scripts more "friendly" and consistent.

Project Member Reported by qyears...@chromium.org, Dec 22 2016 
Currently, there are 32 scripts. They're currently a bit inconsistent:
 - some use argparse and have help, some don't
 - some have a main method, some don't.

Some of them may not be needed any more, and others could be changed or made more friendly. Ideally, to someone not familiar with the Blink Tools/Scripts directory, there should be a smaller number of relatively clear tools.

Comment 1 by jeffcarp@chromium.org, Dec 22 2016 

Yeah! Would be good to do an audit / inventory of all scripts and their uses and irregularities. Also something I think would help a lot is more documentation pages.

Comment 2 by jeffcarp@chromium.org, Jan 4 2017 

Do we have documentation on webkitpy? I can't find any in:
https://chromium.googlesource.com/chromium/src/+/master/docs/

If not, I can make a bug to work on it.

Comment 3 Deleted

Comment 4 by qyears...@chromium.org, Jan 4 2017 

There's documentation about layout tests (including run-webkit-tests), at https://chromium.googlesource.com/chromium/src/+/master/docs/testing/ -- but no overview of webkitpy and the scripts and codebase layout.

It's probably not worth it to describe all of the scripts there in a separate doc file, but for some of them it may be worth expanding a docstring or adding --help output.

Comment 5 by qyears...@chromium.org, Jun 23 2017

Labels: -Type-Bug Type-Task
Summary: Make Blink tools and scripts more "friendly" and consistent. (was: Make scripts in //third_party/WebKit/Tools/Scripts more friendly and consistent.)

Comment 6 by qyears...@chromium.org, Aug 16 2017

Status: Archived (was: Available)
►

Sign in to add a comment