Suggestions interface

[svineet]

The suggestions work on the backend was merged into the suggestions branch in this PR: apertium/apertium-apy#18

Overall, the suggestions route works and is almost production ready, but the following needs to be taken care of (feel free to add anything in the comments):

• The UI in html tools needs refinement. @ftyers and @jonorthwash had some ideas, we could discuss this here.
• Tests could be written for apy endpoints.
• The whole mechanism could use a lot of rigorous testing, there might be bugs.
• ReCAPTCHA API supports localizations and I was thinking of integrating that during the GCI task, but it slipped out of my mind, could be a great idea.

Current interface is at https://github.com/svineet/apertium-html-tools/tree/suggest-word and some of that work was merged into https://github.com/goavki/apertium-html-tools/tree/suggestions but my later improvements still have open PRs to the suggestions branch of html-tools. So we need to work on organizing that stuff.

[jonorthwash]

I merged the two open suggestions PRs (#35, #37) into the suggestions branch. Now @Kira-D should go through your list of to-do points.

[Kira-D]

@svineet can you, please, give me more information about the UI refinement?
What sort of tests do you have in mind?

[sushain97]

moved from PR:

@shardulc @jonorthwash I went ahead and set it up on my server (with a recaptcha key) so we can easily test: https://azurite.skc.name/apertium-html-tools/build/index.eng.html

You need to check Mark unknown words for it to take effect (type some nonsense to translate and you'll see the red).

There are definitely some UI touches that need to take place but I haven't thoroughly tested it yet. Whoever can get to it first should take a crack at it!

I also have a hunch that it's making my CPU spike... Here be dragons. Would appreciate it if someone could confirm that it's not just me.

[shardulc]

@sushain97 When I click the suggest button, nothing happens and I cannot see any network activity either. (The captcha works fine.) However, I can't debug this because I only see min.js 😃

[sushain97]

Let me run make debug next time I'm not afk and it'll be easier.

…

On Dec 4, 2017 12:33 PM, "Shardul Chiplunkar" ***@***.***> wrote: @sushain97 <https://github.com/sushain97> When I click the suggest button, nothing happens and I cannot see any network activity either. (The captcha works fine.) However, I can't debug this because I only see min.js 😃 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#55 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AEBEfq0y98seLmvkA5LpvPRm-gGus5fyks5s9CzNgaJpZM4IfB4S> .

[sushain97]

@shardulc https://azurite.skc.name/apertium-html-tools/build/index.debug.html

Don't try too much to debug it ;) Just make a list of problems.

[shardulc]

List of problems:

1. /suggest is not yet implemented on APy, not even a dummy
2. The captcha is off-center and the text inside the captcha overflows it (see image); perhaps it would be better if we used an invisible captcha?
3. Might be because of point 1, but after you make the suggestion, the modal doesn't go away
4. You can click the suggest button, and generate a POST to APy, even if the captcha is unfulfilled
5. Do we want a lemma translation? Or an in-context translation which may be ambiguously inflected? Either way, the message should be more explicit.
6. It's not immediately obvious that the red unknown words can be clicked.

[sushain97]

Seems like a good set of issues to me, i.e. sufficiently specific to create a GCI task.

Did you not experience CPU spikes while typing in the source text on this branch?

[shardulc]

I tried 10 times and I experienced a CPU spike only once, on my first try, on one of four cores. The other 9 times were completely normal CPU activity.