Updates docs when building a new command. Closes #5835

[SmitaNachan]

Updates docs when building a new command. Closes #5835

[milanholemans]

Thanks @SmitaNachan, we'l ltry to review it ASAP!

[Jwaegebaert]

Hey @SmitaNachan, thanks for the doc updates, but we need to take a different direction. Like Waldek mentioned here: #5835 (comment), the goal is to upgrade the current watch command to start with a new build before attaching the watcher. Sorry for any confusion.

[SmitaNachan]

Hi @Jwaegebaert
Sorry for the confusion, but is it just a documentation level update (as per issue description) or we need to make changes to the command?
Please suggest.

[Jwaegebaert]

@SmitaNachan, you shouldn't necessarily need to change any commands but rather make changes to the way that the npm run watch command works. Be sure to check out Waldeks comment on the issue: #5835 (comment)

[SmitaNachan]

Hi @Jwaegebaert
Will it be a good idea to propose to run npm run build && npm run watch as a command?
This will help us build the command as needed first and then npm can watch for further changes. Please suggest.

[Jwaegebaert]

@SmitaNachan, let's try some different approaches. Running npm run build && npm run watch isn't the most efficient, but we could run benchmark tests to get a clear picture.

I was thinking of exploring TypeScript CLI options more deeply. There's a section about the watcher with some interesting options we could use. https://www.typescriptlang.org/docs/handbook/compiler-options.html

Another idea is to focus on adding new commands during the watch session. Maybe we could include some of our pre-written scripts at the watch launch?

[SmitaNachan]

Hi @Jwaegebaert

I propose making below changes to the package.json:

"scripts": {
    "build": "tsc -p . && node scripts/write-all-commands.js && node scripts/copy-files.js",
    "watch": "tsc -w -p . && node scripts/write-all-commands.js && node scripts/copy-files.js",

Any opinions please?

[Jwaegebaert]

That seems like a good start. Although I'm not quite sure if we'll need the copy-files.js, you'll need to see what the results are if you include or exclude it. Maybe for tsc, it could be handy that we look into some different options as well. There is a --force flag you can use that sounds interesting to use for the watch command.

[SmitaNachan]

Hi @Jwaegebaert

Using --force option with watch gives below error:
error TS5093: Compiler option '--force' may only be used with '--build'