java-design-patterns icon indicating copy to clipboard operation
java-design-patterns copied to clipboard

Attach tutorial links to patterns

Open iluwatar opened this issue 7 years ago • 29 comments

In the pattern template there is section for Tutorials. Here we should list tutorials explaining the pattern. One example is here http://java-design-patterns.com/patterns/hexagonal/.

iluwatar avatar Dec 01 '16 16:12 iluwatar

I checked the hexagonal patterns page. Its having the tutorial link to java-design-pattern (hexagonal pattern) tutorial. Can the patterns also have tutorial links to external sites?

gangadkho avatar Jan 20 '17 09:01 gangadkho

@gangadkho that is a good question. But if we allowed links to external sites and content, would we bump into copyright issues and lawsuits?

iluwatar avatar Jan 21 '17 10:01 iluwatar

@iluwatar Would'nt that be a promotion for external sites? We are just providing the link to their websites(not copying the contents in to our website). Does that sound correct? Correct me if I am wrong.

gangadkho avatar Jan 21 '17 11:01 gangadkho

I don't think it's that simple. For example, see http://www.internetlegalattorney.com/website-external-links-framing-liability-guide/ for potential risks.

iluwatar avatar Jan 22 '17 15:01 iluwatar

Is this issue closed or still open as three blog present in sites are linked in respective patterns? Also what is the decision on using external links ?

jaysar avatar Jan 24 '17 23:01 jaysar

I would like to hear what @markusmo3 and @npathai think about this.

iluwatar avatar Jan 26 '17 06:01 iluwatar

I dont think hyperlinking would be an issue.

“…hyperlinking does not itself involve a violation of the Copyright Act (whatever it may do for other claims) since no copyright is involved. The customer is automatically transferred to the particular, genuine Web page of the original author. There is no deception in what is happening. This is analogous to using a library’s card index to get reference to particular items, albeit faster and more efficiently.”

Thats what i learned when the issue first came up a couple of years ago

"However, using external links on your website may create legal liability in some cases. External links can be unlawful when they i) cause consumer confusion; ii) encourage or facilitate illegal copyright infringement by others; or iii) violate other laws."

i) they wont, its a hyperlink, in blue color and most of the times the URL is in full text ii) might be an issue, if the linked site is infringing, but i think we can take that risk iii) nope, unless we link to drugsites or other dubious stuff

If the added links are checked and approved by a contributor (that means the site is working and looks at least somewhat credible), then i dont see any problem in linking to other tutorials. With that we are providing publicity and also indirectly give money (with page hits/ads) to the original tutorial author.

Source of quotes: http://www.internetlegalattorney.com/website-external-links-framing-liability-guide/

markusmo3 avatar Jan 29 '17 11:01 markusmo3

Thank you @markusmo3 for the statement. In light of this, I think we can start accepting links to other sites as well.

iluwatar avatar Jan 30 '17 18:01 iluwatar

where is the Design description?

9527BOM avatar Feb 28 '17 12:02 9527BOM

The links are provided in the pattern's README.md. For example Hexagonal Architecture has one tutorial link provided here.

iluwatar avatar Feb 28 '17 17:02 iluwatar

These are our current links to tutorials:

Right now we only have three tutorial blog posts, and I see issue #341 requesting more blog posts.

Do we have any preference for which website we link to? Here are some examples of things I could link to:

  • Iterator: http://www.tutorialspoint.com/java/java_using_iterator.htm
  • Abstract Factory: http://www.tutorialspoint.com/design_pattern/abstract_factory_pattern.htm

mattj256 avatar May 27 '17 15:05 mattj256

@mattj256 the links to tutorialspoint seem ok so we could add them.

iluwatar avatar May 29 '17 17:05 iluwatar

@iluwatar I'd be happy to add the external links. Would you assign to me?

OrangePants-R avatar Oct 13 '20 17:10 OrangePants-R

Ok @OrangePants-R

iluwatar avatar Nov 22 '20 19:11 iluwatar

Is it available @iluwatar

kanwarpreet25 avatar Dec 14 '20 09:12 kanwarpreet25

Yes the issue is open @kanwarpreet25

iluwatar avatar Dec 14 '20 18:12 iluwatar

Working on it @iluwatar

kanwarpreet25 avatar Dec 17 '20 05:12 kanwarpreet25

Ok @kanwarpreet25

iluwatar avatar Dec 29 '20 08:12 iluwatar

Help wanted

iluwatar avatar Oct 09 '21 18:10 iluwatar

@iluwatar It's not clear from this thread what type of tutorial external links should be added to patterns. As an example, tutorial points have been mentioned. I will assume that any site that has a good use case explanation for the pattern can be added to the tutorials list. If it is so, please assign it to me. I will try to do some homework.

blueberry404 avatar Oct 14 '21 21:10 blueberry404

@blueberry404 you got it right. There's no restriction really, as long as the provided link is useful we can add it. Assigned to you now.

iluwatar avatar Oct 19 '21 13:10 iluwatar

Please ignore the commit with SHA "d58fd4d" shown here. I added a wrong commit message having the name of Bridge pattern while it should have mentioned Builder pattern. I have changed the message and the correct commit is with SHA "aefa1a4".

blueberry404 avatar Oct 23 '21 09:10 blueberry404

Please indicate if you are still working on this issue @blueberry404

iluwatar avatar Oct 24 '21 15:10 iluwatar

@iluwatar I have unassigned myself this issue. Please feel free to assign it to anyone.

blueberry404 avatar Oct 24 '21 16:10 blueberry404

Hi, I recently studied design patterns and worked on a project too using microservices and API-Gateway. Shall I contribute some tutorial links, on some topics that I came across while working on the project? I think they will make a good fit here!!

vaibhav-if avatar Oct 26 '21 16:10 vaibhav-if

Sounds great @vaibhav-if. I'll assign the issue to you!

iluwatar avatar Oct 30 '21 18:10 iluwatar

Hi @iluwatar, I have added a few PRs to be in time for hacktoberfest, will add more in coming days.

vaibhav-if avatar Oct 31 '21 14:10 vaibhav-if

Hi @iluwatar, I'm a beginner to all this and recently I've learnt java and javascript, I'm out here looking for projects to improve my skills but having a bit trouble to understand things here. It would be great help if you guide me to some resources which will help me to learn more in java and javascript, so that I can start contributing to project like these. Sorry for being off topic but please help me out.

ghost avatar Dec 08 '21 08:12 ghost

These are our current links to tutorials:

Right now we only have three tutorial blog posts, and I see issue #341 requesting more blog posts.

Do we have any preference for which website we link to? Here are some examples of things I could link to:

  • Iterator: http://www.tutorialspoint.com/java/java_using_iterator.htm
  • Abstract Factory: http://www.tutorialspoint.com/design_pattern/abstract_factory_pattern.htm

Hey,
You can refer this too - https://www.scaler.com/topics/design-patterns/factory-design-pattern/

bikashdaga avatar Aug 01 '22 14:08 bikashdaga