PrismLibrary / Prism

Prism is a framework for building loosely coupled, maintainable, and testable XAML applications in WPF, Xamarin Forms, and Uno / Win UI Applications..
Other
6.35k stars 1.64k forks source link

Need a website! #411

Closed brianlagunas closed 7 years ago

brianlagunas commented 8 years ago

We need to create a website that is hosted on our GitHub Pages repo:

https://github.com/PrismLibrary/prismlibrary.github.io

Nothing too fancy, just a clean and simple site. We can start with a single page for now, and then add navigation later on.

eriawan commented 8 years ago

hi @brianlagunas

I'd like to help :smile:

Do we have a sample project? It'll be easier to have a web that describes Prism using sample codes of a small app.

bartlannoeye commented 8 years ago

Hey @eriawan

We got several samples for each platform on the Prism organization:

There's also quite some effort done for documentation (mainly on WPF, but XF is coming along as well).

I don't think it's necessary to duplicate this effort, but mentioning (showing) how easy it is to get started might be a good sales point indeed.

jcktlr commented 8 years ago

@brianlagunas Are you thinking of using a static site generator like Jekyll?

I would like to help if I can. Though, I am not very familiar with the github workflow.

brianlagunas commented 8 years ago

Sure. That would work.

ganchito55 commented 8 years ago

I have created a website for this project, I hope you like it. Prism helps me a lot and I wanted to help it.

eriawan commented 8 years ago

@brianlagunas now that we have prismlibrary.girhub.io, could I just copy and paste some of the MD files that we already have? we could adjust the overall look later, as we should have content soon based on existing documentation that we have now.

bartlannoeye commented 8 years ago

We don't want too much duplicate content to maintain, so I wouldn't just copy/paste our docs. Either we maintain the docs here and keep the site minimal (doc wise), or we move them all.

eriawan commented 8 years ago

@brianlagunas IMHO it's better to move them all to the github.io website. What do you think?

brianlagunas commented 8 years ago

Yeah, I am okay with moving docs to GitHub website. Probably easier to find there.

eriawan commented 8 years ago

@brianlagunas @bartlannoeye OK, so could I copy and paste the Prismlibrary documentation to the github.io site? I'll copy and paste all of them first, then we can safely delete the MD docs on the existing Prismlibrary, Or we should ease the migration by simply say that it's moved to the github.io website (after the copy and paste is done).

brianlagunas commented 8 years ago

Don't delete the docs from the current repo. Let's get the website up first and then I will remove the docs when everything is in place.

eriawan commented 8 years ago

ok, thanks for your quick reply, @brianlagunas :)

I am going to clone both the repo and create a new branch on the github.io page now.

joacar commented 8 years ago

What do you think about using read-the-docs?Used by other Microsoft .NET projects (aspnet and EF two examples). It renders documentation from Markdown-ish code and pulls the code from repo so I suggest creating Prism.Documentation and move the docs there. Here is how EF looks and the source from which it's generated.

brianlagunas commented 8 years ago

Doesn't look like a bad option. When I get some time I'll look more into this.

riandesign commented 7 years ago

If you still need a website, please tell me. I have an agency in Brazil and I'd love to help! Check my portfolio: www.riandesign.com.br

brianlagunas commented 7 years ago

Would love a website. I'll never get around to building one :)

riandesign commented 7 years ago

Ok! Would you install in a domain like prism.com or where? What would be the content of this site? Please, tell me how you'd like it, so I create a mockup to show you.

brianlagunas commented 7 years ago

I do have the http://prismlibrary.com domain. I think ideally it would be good if the website was placed in this repo: https://github.com/PrismLibrary/prismlibrary.github.io

The website should be pretty simply. I haven't put much time into thinking about what content is should have, but it looks like it would be close to the https://angularjs.org/ site. Simple website that provides the GitHub link, the Documentation link. A section for Learn where I can place videos (youtube) and links to my pluralsight courses. A way to link to various blogs posts on my blog, or even other peoples blogs. Point people to the slack channel, report bugs, follow me on twitter, and stuff like that. I would even really like it to be localized to Japanese. I can do the text translation, but the mechanism needs to be on the site to change languages.

Those are my initial thoughts. Like I said, I really have thought about it in much detail yet, so I am sure I am missing something :)

eriawan commented 7 years ago

@brianlagunas cool! Since you have decided that we're going to use prismlibrary.github.io, could I start a rough prototype?

riandesign commented 7 years ago

Hi @eriawan , I already created a mockup. @brianlagunas , please let me know what do you think about it on this link in real size mockup:

preview.riandesign.com.br/prismlibrary

Where "Learn" page will have subpages such as Videos and Pluralsight courses. And "Discuss" can have subpages like Blogs, Slack channel, Report bugs (external link), Twitter etc.

I also attached its image below. If you want any changes or want something different, please tell me.

preview1

bartlannoeye commented 7 years ago

@riandesign looks great. Maybe we should add a mention to the NuGet packages as an alternative way to use Prism?

brianlagunas commented 7 years ago

@riandesign dude! This is beautiful! I love it. You rock!

brianlagunas commented 7 years ago

Also, I agree with @bartlannoeye, but we can figure out the content as we go. The layout is great.

riandesign commented 7 years ago

@brianlagunas @bartlannoeye I'm glad you liked it! Maybe something like this?

preview2

brianlagunas commented 7 years ago

Well, I am actually thinking that the content area for "Setup the Prism Source Code" should be more of a "Getting Started".

Step 1 - Install the Template Pack (small screenshot of template pack ) Step 2 - Create a Project (small screenshot of the project templates) Step 3 - Run the code. (small screenshot of running app, preferably a mobile app)

Something like that, but show "Fast and Easy" type of stuff. More thought probably need to go into it, but something along the lines of how easy it is to start writing Prism apps.

I'm not sure about the NuGet section. Something just seems a little off. I can't put my finger on it yet.

brianlagunas commented 7 years ago

Another thing I would like to highlight is our Slack channel. Maybe right under the main section. "Join our Slack Channel" or something. Not sure.

djcparker commented 7 years ago

For "getting started" maybe "Quick start", because it is quick.. And you need to put "BOOM!" in there as well, its the part of Brian's demos that I love :)

djcparker commented 7 years ago

@riandesign looks really good!

eriawan commented 7 years ago

@riandesign great! we should use this design as our starting visual design for the Prism website.

riandesign commented 7 years ago

@brianlagunas , please let me know what you think about this mockup in the link below. Did I forget something?

preview.riandesign.com.br/prismlibrary/2.php

brianlagunas commented 7 years ago

looks great!

riandesign commented 7 years ago

Nice. So, I'll develop it, ok? About the content, texts etc, when you have them, could you send them to my email, please?

brianlagunas commented 7 years ago

Yes, please develop it. For now you can use the text you have. When you check it into the website repo, I will update the text. This way you don't have to wait on me for anything.

riandesign commented 7 years ago

@brianlagunas , do you have a server already? Where will we host it?

PS: the website is not developed yet.

bartlannoeye commented 7 years ago

Hosting is done on GitHub pages. Simply send a PR to this repository: https://github.com/PrismLibrary/prismlibrary.github.io

garrypolley commented 7 years ago

I was attempting to look at what's in the "docs" folder via github.io and was not able to see a deployed version of all the nice docs in this repository.

Has it been setup to use the folder? https://github.com/blog/2228-simpler-github-pages-publishing

Would it be a bad idea to let what's in there now be seen? Minimally styled with what's already there?

brianlagunas commented 7 years ago

@garrypolley on the readme file there is a link to the docs: http://prismlibrary.readthedocs.io/en/latest/

We do not have a website yet.

riandesign commented 7 years ago

Yes, I'm still developing it. I'm doing at my free time, but I'll finish it probably in a couple weeks, ok? Anything you want, please tell me.

brianlagunas commented 7 years ago

@riandesign no hurry. I understand you are doing this on your limited free time and we appreciate your effort.

brianlagunas commented 7 years ago

Have you made any progress on this yet?

riandesign commented 7 years ago

@brianlagunas sorry this huge delay! I'll finish it probably next week, ok? As soon as it's done I put it online. By the way, how can I send the files to you?

bartlannoeye commented 7 years ago

@riandesign you can send a PR to https://github.com/PrismLibrary/prismlibrary.github.io

brianlagunas commented 7 years ago

You can also email them to me directly. Just let me know when you are done. Thanks.

riandesign commented 7 years ago

@brianlagunas , I just sent a PR to https://github.com/PrismLibrary/prismlibrary.github.io Please, let me know if I did right, ok?

Note: the homepage is done, but the internal pages (Documentation, Learn, Discuss) are under construction, because I'm not sure what is the content for those pages.

Can you tell me or send me the content just to create a layout for them and put in there? After that, you'll be able to update the content easily, if you want it.

riandesign commented 7 years ago

@brianlagunas I updated the files. Please, let me know if I did correctly.

Thirukumaranskp commented 7 years ago

On Fri, 26 May 2017 at 10:44 PM, Brian Lagunas notifications@github.com wrote:

Closed #411 https://github.com/PrismLibrary/Prism/issues/411.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/PrismLibrary/Prism/issues/411#event-1099270679, or mute the thread https://github.com/notifications/unsubscribe-auth/AF2BewNb_yWIaif11ejm23LHapuzxMNqks5r9whxgaJpZM4HI-hf .

-- Hi,

Thanks & Regards Thirukumaran

lock[bot] commented 4 years ago

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.