Improve readme files for users and developers

[bobbingwide]

Improve readme files for users and developers

[bobbingwide]

Trying to follow my new instructions on cwiccer.com I found the block but when I clicked on Add block an error message was displayed in the block inserter. I'll need to repeat the experiment to reproduce then analyze the problem.

[bobbingwide]

I reproduced the problem in cwiccer.com and herbmiller.me but don't yet know the cause of the problem.
I think this should be a separate issue.

[bobbingwide]

Having improved the readme.txt file in v1.0.1 we now get different results.
It's a lot easier to find the block.
Basically I've implemented the equivalent of the black hat technique of keyword stuffing.
I don't think this is what WordPress.org would want.
I've updated my findings in https://herbmiller.me/sb-children-block-my-first-single-block-plugin/
I think I should raise an issue against Gutenberg.

[bobbingwide]

Now that WordPress 5.5 has been released I retested the installation

• On a new site I searched for sb and the block/plugin was listed.
• Then I clicked on Add block and the plugin was installed and the block added to the page.
• The Add block button wasn't disabled though.
• Clicking on it again displayed "This block is already installed. Try reloading the page."
• I reloaded the page and searched for sb again.
• The response was "No blocks found in your library. These blocks can be downloaded and installed.
• And SB Children block was the only block listed again.

[bobbingwide]

I think I should raise an issue against Gutenberg.

I discussed this briefly on Slack and said I might raise an issue entitled
Block Directory Search susceptible to keyword stuffing.

I haven't raised it yet.

[bobbingwide]

The latest situation is that I can no longer find the SB Children block using the block directory search.
I don't know why not. I've asked on the #pluginreview channel.
https://wordpress.slack.com/archives/C1LBM36LC/p1604166543315800

[bobbingwide]

I also asked in #meta. Dion Hulse replied

It looks like it might’ve dropped out the of the search index for some reason, unsure why, I’ve removed it from the block directory, and then re-added it (like you attempted it looks like) and it should now show up.

Re: like you attempted. I did recheck the zip file and got told it was already in the block directory. Hence the questions.

[bobbingwide]

With the current version of the block, v1.1.0, the problem with installing in the editor doesn't occur any more.
There's a new version coming, v1.2.0. I'll need to retest when it's on wordpress.org

[bobbingwide]

v1.2.3 now available with an updated src/README.md