java-design-patterns
java-design-patterns copied to clipboard
Attach tutorial links to patterns
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/.
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 that is a good question. But if we allowed links to external sites and content, would we bump into copyright issues and lawsuits?
@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.
I don't think it's that simple. For example, see http://www.internetlegalattorney.com/website-external-links-framing-liability-guide/ for potential risks.
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 ?
I would like to hear what @markusmo3 and @npathai think about this.
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/
Thank you @markusmo3 for the statement. In light of this, I think we can start accepting links to other sites as well.
where is the Design description?
The links are provided in the pattern's README.md
. For example Hexagonal Architecture has one tutorial link provided here.
These are our current links to tutorials:
- queue-load-leveling: Queue-Based Load Leveling Pattern
- proxy: Controlling Access With Proxy Pattern
- hexagonal: Build Maintainable Systems With Hexagonal Architecture
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 the links to tutorialspoint seem ok so we could add them.
@iluwatar I'd be happy to add the external links. Would you assign to me?
Ok @OrangePants-R
Is it available @iluwatar
Yes the issue is open @kanwarpreet25
Working on it @iluwatar
Ok @kanwarpreet25
Help wanted
@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 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.
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".
Please indicate if you are still working on this issue @blueberry404
@iluwatar I have unassigned myself this issue. Please feel free to assign it to anyone.
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!!
Sounds great @vaibhav-if. I'll assign the issue to you!
Hi @iluwatar, I have added a few PRs to be in time for hacktoberfest, will add more in coming days.
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.
These are our current links to tutorials:
- queue-load-leveling: Queue-Based Load Leveling Pattern
- proxy: Controlling Access With Proxy Pattern
- hexagonal: Build Maintainable Systems With Hexagonal Architecture
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/