Missing Descriptions for Formula Components in `haydavies`

[BernatNicolau]

The formula components for the haydavies function seems to not be properly defined. The current formula is:

$I_{d} = DHI \left( A R_b + (1 - A) \left(\frac{1 + \cos \beta}{2}\right) \right)$

However, the documentation does not provide definitions or explanations for the components $A$ and $R_b$. While $DHI$ and $\beta$ are relatively straightforward, I feel it would be beneficial to include their descriptions for completeness.

Additionally, isotropic, klutcher and reindl also lack description of formula components.

Request

1. Update the documentation for the haydavies function to include descriptions for the following components:

   • $A$
   • $R_b$
   • $DHI$
   • $\beta$

2. Update the documentation for the isotropic, klutcher and reindl (shall different issues be created for each function?)

I think that providing these definitions will improve clarity.

Thank you!

[AdamRJensen]

I do agree that it seems poorly documented and that the other variables should be defined. While we're at it, equations such as these belong in the Notes section of the documentation.

@BernatNicolau are you up for making a PR to improve the haydavies function?

[BernatNicolau]

I will try to work on it but I don't think I will be able to prioritize it. I will post a comment when I start to work on the PR, so if anyone feels like doing it, go ahead :)

[RDaxini]

I'd be happy to work on the documentation for at least one of these functions. I don't want to hijack your work here though @BernatNicolau , let me know if you were planning to make a start soon and/or whether my contribution would be helpful here.
It was nice to meet you at PVPMC btw, happy to see you are already very active now with pvlib!

shall different issues be created for each function?

I think this single issue is sufficient but separate PRs for each function might help with overall organisation of these developments.

[BernatNicolau]

Hi @RDaxini ! Please go ahead, I don't intend to start documenting this anytime soon ;)

It was great meeting you as well! That introductory class was what I needed to start contributing, so thank you for that!! Hope to see you again somewhere soon :)

[RDaxini]

@BernatNicolau happy to hear the tutorial was helpful!

I have created a few PRs on this subject. Feel free to leave a review (another great type of contribution) if you have time! Your thoughts on the comments I have left or any of the code edits would be more than welcome. If you'd like some help with using any of the review features on github too then let us know.