Hi Riyafa,

this is a great idea!
Looking a the installation video I had a few thoughts on things that we
could improve on the website :)

1) We should update our site to point to the
   AsterixCodeFormatProfile.xml [1] that is identical (except for the
   name) to the HyracksCodeFormatProfile. While it is a little
   confusing that we use another project’s code format profile, it does
   make sense, as Apache VXQuery and Apache AsterixDB share the same
   foundation (Hyracks and Algebricks) and as that foundation is part
   of the Apache AsterixDB project.

2) It would be great if we also had written instructions for IntelliJ
   on our website. More precisely, we probably should have instructions
   for "IDE Setup" that contain the common git steps and then specific
   Eclipse and IntelliJ steps.

3) We should (for now) remove the "Import Hyracks Code Base" from the
   website (as is doesn’t work anymore) and bring it back, once we’ve
   caught up with the latest Hyracks changes (and then point to the
   Apache AsterixDB repository).

Also, I had a few thoughts how you could tighten up the video a bit to
make it shorter and thus more likely that viewers will watch it until
the end:

1) If the git clone takes too long, it might be good to cut the cloning
   progress out of the video.

2) Importing and exporting the code format file with Eclipse should not
   be necessary, just importing it into the IntelliJ’s Eclipse Code
   Formatter should be enough. In that case the instructions on the
   IntelliJ website are also not required.

3) Instead of first cloning the GitHub mirror of the Apache repo to
   your machine, it might be better to only show the forking in GitHub
   and the the cloning of the forked GitHub branch to you machine. It
   would save some time and explanation.

4) It would be be quicker, if you would not need to to look for the
   correct menu during the recording.

Also, It’d be nice to start of a clean IntelliJ installation so that
you can actually show e.g. the installation of the plugin.

Also, a few comments on the debugging video:

1) The volume is very low - but you already mentioned that in your
   comment on YourTube.

2) The query should probably match.xq and not match.mq.

3) It seems that step-into in the debugger sometimes didn’t work, as
   the line numbers in the executable and in the debugger didn’t align.
   Maybe the debugger had a slightly modified version of the code?

I'm pretty sure that we can easily do the changes to our site. However,
I'm not sure how easy it is to re-create those videos and if there's a
point in doing so.

Thoughts?

Cheers,
Till

[1] https://cwiki.apache.org/confluence/display/ASTERIXDB/Formatting

On 7 Nov 2016, at 17:12, Riyafa Abdul Hameed wrote:

> Hi,
>
> I have created a video on "How to setup VXQuery in IntelliJ?". It is not
> very clear, but hopefully would help any novice developers to get started:
>
> https://youtu.be/8LJUqYKx5rM
>
> Also I have created a video on how to remote debug VXQuery using IntelliJ:
>
> https://youtu.be/4MhbWM0NKS4
>
> Thank you.
> Riyafa

Reply via email to