Line editing for Pointers

[christinerose]

No description provided.

[christinerose]

Excellent suggestions, @sabine! I've committed them to the file.

[christinerose]

Great! Now that you both have looked over it, is it ready to merge? (@cuihtlauac & @sabine)

[sabine]

Yes, we can merge that, but reading the overall tutorial, I think this requires some deeper editing and restructuring than just line editing. It's the same situation as we have in many of the other tutorials.

[christinerose]

Good to know @sabine. What can I do to help with that?

[sabine]

The main problem with these tutorials is that they target a very specific kind of user - and there is no consistency on the previous knowledge the tutorials require.

In this tutorial, the targeted user is apparently someone who knows pointers because they know the C programming language.

[christinerose]

The main problem with these tutorials is that they target a very specific kind of user - and there is no consistency on the previous knowledge the tutorials require.

In this tutorial, the targeted user is apparently someone who knows pointers because they know the C programming language.

Do you have some suggestions on how to make it more consistent? I would be more than happy to work on that.

Also, would it be helpful to write an introduction to Pointers?

[cuihtlauac]

The main problem with these tutorials is that they target a very specific kind of user - and there is no consistency on the previous knowledge the tutorials require.

In this tutorial, the targeted user is apparently someone who knows pointers because they know the C programming language.

This tutorial needs a serious rewrite. I don't even think using the term “pointer” makes any sense at all in the context of OCaml. However, this is not a rewrite likely to happen in a short time. In the meantime, it's always better to improve what's possible, that will always be helpful for a more in-depth rewrite.

[christinerose]

The main problem with these tutorials is that they target a very specific kind of user - and there is no consistency on the previous knowledge the tutorials require.
In this tutorial, the targeted user is apparently someone who knows pointers because they know the C programming language.

This tutorial needs a serious rewrite. I don't even think using the term “pointer” makes any sense at all in the context of OCaml. However, this is not a rewrite likely to happen in a short time. In the meantime, it's always better to improve what's possible, that will always be helpful for a more in-depth rewrite.

Agreed. It's good to start somewhere, and we can keep improving iteratively! 😄

[christinerose]

Shall we merge this one for now until the indepth rewrite @cuihtlauac & @sabine

[sabine]

@christinerose Indeed, it is merged.

[christinerose]

Oh Great! Thank you!